安装Logstash · Logstash中文文档（个人翻译）

[TOC] ### 安装Logstash > NOTE ： Logstash支持Java8，不支持Java9，使用[Oracle 版](http://www.oracle.com/technetwork/java/javase/downloads/index.html)JDK或开源的[OpenJDK](http://openjdk.java.net/) 使用下面的命令检查你的Java版本： ```shell java -version ``` 如果系统中安装了Java，则会输出类似下面的信息： ```shell java version "1.8.0_65" Java(TM) SE Runtime Environment (build 1.8.0_65-b17) Java HotSpot(TM) 64-Bit Server VM (build 25.65-b01, mixed mode) ``` 在某些Linux系统中，安装之前你可能还需要设定`JAVA_HOME`环境变量，特别是你使用的是二进制安装方式。Logstash在安装过程中需要Java环境来安装正确的启动方法(SYSV init 脚本,开机自启,systemd)。如果Logstash无法找到正确的`JAVA_HOME`变量，你将会收到一个错误信息，并且Logstash将不能正确的启动。 #### Install from a Downloaded Binary(二进制安装) 　　[下载](https://www.elastic.co/downloads/logstash)适用于你的环境的安装文件并解压。注意解压目录名中不要包含(:)符号。（目录名中不要有冒号） > NOTE：这些包可以在Elastic的许可下免费试用。其中包含开源和免费的商业特性和可选的付费商业特性。开始为期[30天](https://www.elastic.co/guide/en/elastic-stack-overview/6.4/license-management.html)的付费全功能版本。更多信息参考“[订阅](https://www.elastic.co/subscriptions)”页面。 > > 或者，你可以下载一个`oss`包，包含Apache2.0许可下的所有特性。在支持的Linux发行版，你也可以使用包管理器来安装Logstash。 #### Installing from Package Repositories 　　我们同时也提供了基于YUM和APT包管理器的源。注意我们只提供了二进制包，而不提供源码包。因为这是计划的一部分。（因为Logstash把包作为构建的一部分进行构建。原文：the packages are created as part of the Logstash build.）　　我们已经将Logstash源按版本拆分为单独的URL，以避免大版本升级可能带来的意外情况。对于所有6.x.y版本，使用6.x作为版本号。　　我们使用PGP key [D88E42B4](https://pgp.mit.edu/pks/lookup?op=vindex&search=0xD27D666CD88E42B4),下面的指纹信息来签名我们的包，许可来自 [https://pgp.mit.edu](https://pgp.mit.edu) ``` 4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4 ``` ##### APT 下载并安装以下公钥： ```shell wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add - ``` 在Debian上你可能还需要安装`apt-transport-https`包才能继续： ```shell sudo apt-get install apt-transport-https ``` 将源文件保存在`/etc/apt/sources.list.d/elastic-6.x.list`： ```shell echo "deb https://artifacts.elastic.co/packages/6.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-6.x.list ``` > WARNING：使用如上的`echo`命令来添加Logstash源，不要使用`add-apt-repository`否则系统会添加一个`deb-src`源，但我们并没有对应的包。如果你有一个`deb-src` 源，你会看到如下的错误信息： > > ```shell > Unable to find expected entry 'main/source/Sources' in Release file (Wrong sources.list entry or malformed file) > ``` > > 这种情况只需要从`/etc/apt/sources.list`文件中删除`deb-src`源即可。执行`sudo apt-get update`准备好之后使用下面的明星安装： ```shell sudo apt-get update && sudo apt-get install logstash ``` 查看[运行Logstash](http://www.elastic.co/guide/en/logstash/6.4/running-logstash.html)查看如何以系统服务管理Logstash。 ##### YUM 下载并安装公钥： ```shell rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch ``` 在`/etc/yum.repos.d/`目录下创建一个`.repo`结尾的文件，内容如下： ```text [logstash-6.x] name=Elastic repository for 6.x packages baseurl=https://artifacts.elastic.co/packages/6.x/yum gpgcheck=1 gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch enabled=1 autorefresh=1 type=rpm-md ``` 准备好之后运行下面的命令来安装： ```shell sudo yum install logstash ``` > WARNING：在RPM v3或更低版本源不再支持，如CentOS5。查看[运行Logstash](http://www.elastic.co/guide/en/logstash/6.4/running-logstash.html)查看如何以系统服务管理Logstash。 ##### Docker 在Elastic Docker仓库，已经提供了可以作为容器运行的Logstash镜像。查看[Running Logstash on Docker](https://www.elastic.co/guide/en/logstash/current/docker.html)来查看如何以容器的方式运行和配置Logstash。