.. _install-doc:
安装Varnish
==================
.. no section heading here.
因为varnish是开源软件,你可以选择通过二进制包安装或者自己编译源代码安装。通过包安装或者编译源代码纯粹是个人喜好。
如果你不知道如何选择哪种安装方式,我们建议你通读本节,然后选择适合你的安装方式。
源代码 或 安装包?
-------------------
在绝大数操作系统上,通常可以通过对应的系统管理包安装。 典型示例
FreeBSD
-------
二进制包:
``pkg_add -r varnish``
从源代码:
``cd /usr/ports/varnish && make install clean``
Red Hat / CentOS
----------------
我们尽可能地保证最新版本的预编译RPM包(el5和el6)在`repo.varnish-cache.org `_.上可用。
查看在线的`红帽子安装指导`_获得更多信息 .
Varnish已存在`EPEL`_ 库中,
但是由于新版本的Varnish有不兼容语法规则,库中只有老版本的Varnish可用。
基于上述原因,我们推荐你直接通过我们的库安装最新版本。
Debian/Ubuntu
-------------
Varnish随Debian和Ubuntu发行。通过执行``sudo apt-get install
varnish``,就可以获得Varnish。
请注意那可能不是最新的版本。 如果你需要一个较新的版本,可以查看在线的安装指导`Debian
`_ 或者 `Ubuntu
`_.
从源代码中编译Varnish
=============================
如果没有二进制包适合你的系统,或者你有其他原因想编译Varnish,参考下面的步骤:
下载适合的Varnish的tarball,你可以在这里下载
http://repo.varnish-cache.org/source/ 。
或者,如果你想研究Varnish,你可以通过下面命令克隆我们的git库:
``git clone git://git.varnish-cache.org/varnish-cache``
在Debain / Ubuntu上构建依赖包
--------------------------------------
为了从源代码上构建Varnish,你需要安装一些包。在Deian或者Ubuntu上,需要安装下面的包:
* `autoconf`
* `automake1.1`
* `autotools-dev`
* `groff-base`
* `make`
* `libedit-dev`
* `libncurses-dev`
* `libpcre3-dev`
* `libtool`
* `pkg-config`
* `python-docutils`
如果你需要从git上构建,你也需要下面的包:
* `python-sphinx` (可选, 如果你需要构建文档)
Build dependencies on Red Hat / CentOS
在Red Hat / CentOS上构建依赖包
--------------------------------------
在Red Hat或者CentOS上构建Varnish,你需要下面安装下面的包:
* `automake`
* `autoconf`
* `groff`
* `libedit-devel`
* `libtool`
* `ncurses-devel`
* `pcre-devel`
* `pkgconfig`
* `python-docutils`
如果你需要从git上构建,你也需要下面的包:
* `python-sphinx` (可选, 如果你需要构建文档)
编译Varnish
-----------------
配置依赖需要上面合适包,请在确认一下::
cd varnish-cache
sh autogen.sh
sh configure
make
`configure`脚本需要一些参数,不像其他参数从现在你可以忘记了,基本Varnish所有的东西都可以通过运行参数进行调整。
在你安装之前,你可能行执行测试套件。运行的时候,泡杯茶吧,测试需要好几分钟::
make check
别担心一个或者两个测试失败,一些测试对时间太敏感(请告诉我们那些,我们好修复),但是如果很多失败,特别`b00000.vtc`测试失败,问题相当严重。在没搞清楚之前,不要乱动。
安装
----------
最后执行: ``sudo make install``
现在Varnish安装在`/usr/local`、 `varnishd`程序安装在`/usr/local/sbin/varnishd`、默认的配置文件安装在 `/usr/local/etc/varnish/default.vcl`。
在正确安装之后,你可以继续阅读:ref:`tutorial-index`.