安装前说明

【一】安装Docker

本教程使用的安装方法为Docker的镜像安装，干净，省力，所以需要在安装环境内安装docker。您可以前往官网下载并安装对应系统的Docker，请下载并安装最新的版本，或至少安装17.0以上的版本。
本教程使用的系统为CentOS 7，该系统的安装可参考我的另一篇文章：在CentOS 中安装Docker

【二】适用对象

本安装教程适用于运行Linux、MacOS、Windows操作系统的电脑或虚拟机。
在MacOS系统中安装前，需要设置IP别名，操作步骤如下：

1. 在菜单栏点击docker图标，选择Preferences > Advanced，在Docker subnet一栏中复制IP地址，或在终端中通过命令docker run --rm --net host eclipse/che-ip:nightly查询IP
2. 在终端中输入以下命令来设置IP别名，其中${IP}为您上一步查询到的IP

$ sudo ifconfig lo0 alias ${IP}

【三】服务器配置

最低配置：1 CPU；2GB RAM；3GB 磁盘空间

【四】 配置默认端口

运行Che所需的默认端口是8080。Che在启动时执行预检时会验证端口是否可用。您也可以在启动时传入-e CHE_PORT=${your host} start命令来更改Che启动的端口。请确保以下端口都已经打开，并且没有被防火墙或其他第三方应用阻止，除非另有说明，所有端口均为TCP，Che常用端口如下：

已知的问题

您可以搜索Che的GitHub Issues页面，被标记为kind/bug的即已知问题的项目。

安装单用户版Eclipse Che

运行安装命令

在终端中运行以下命令

#此为精简安装模式，但命令行会提示你下一步命令该如何输入
$ docker run -it eclipse/che start

#此为完整安装命令，其中<path>为本地存储eclipse che配置文件的地址
$ docker run -it --rm -v /var/run/docker.sock:/var/run/docker.sock -v <path>:/data eclipse/che start

#执行案例
$ docker run -it --rm -v /var/run/docker.sock:/var/run/docker.sock -v /home/che:/data eclipse/che start

#案例输出
WARN: Bound 'eclipse/che' to 'eclipse/che:6.11.1'
INFO: (che cli): Pulling image alpine:3.4
INFO: (che cli): Pulling image eclipse/che-ip:6.11.1
INFO: (che cli): 6.11.1 - using docker 18.06.1-ce / native
...（第一次运行时会下载缺少的文件，此处省略）
INFO: (che config): Generating che configuration...
INFO: (che config): Customizing docker-compose for running in a container
INFO: (che start): Preflight checks
         mem (1.5 GiB):           [OK]
         disk (100 MB):           [OK]
         port 8080 (http):        [AVAILABLE]
         conn (browser => ws):    [OK]
         conn (server => ws):     [OK]

INFO: (che start): Starting containers...
INFO: (che start): Services booting...
INFO: (che start): Server logs at "docker logs -f che"
INFO: (che start): Booted and reachable
INFO: (che start): Ver: 5.20.1
INFO: (che start): Use: http://172.19.20.180:8080
INFO: (che start): API: http://172.19.20.180:8080/swagger

修改默认端口

1. 在执行Eclipse Che运行命令时添加-e CHE_PORT=${your host}参数来为本次运行指令临时端口，完整命令如下：

$ docker run -it --rm -v /var/run/docker.sock:/var/run/docker.sock -v <path>:/data -e CHE_HOST=<your-ip-or-host> eclipse/che start

2. 修改安装目录下che.env文件来永久修改che的运行默认端口

   1. 打开安装目录下的che.env文件
   2. 搜索CHE_PORT，找到如图红框中的内容
      
   3. 删除#CHE_PORT=8080前注释用的#号，并修改=号后的端口号
   4. 保存退出，并重新运行Eclipse Che，即可使用新端口进入Che

打开Che

打开浏览器，在浏览器中输入http://${your ip}:${your port}来打开Eclipse Che，出现如下内容则安装成功

安装多用户版Eclipse Che

运行安装命令

$ docker run -it -e CHE_MULTIUSER=true -e CHE_HOST=${EXTERNAL_IP} -v /var/run/docker.sock:/var/run/docker.sock -v ~/.che-multiuser:/data eclipse/che start

1. ~/.che-multiuser可以是任何的本地路径。该路径用来存储Che的数据和配置；
2. ${EXTERNAL_IP}应该是将访问Che实例的所有用户都可访问的公共IP。如果您是在本地运行Che并且所有用户都将从同一局域网络中访问它，则可以删除-e CHE_HOST=${EXTERNAL_IP}参数。在这种情况下，Che CLI将尝试自动检测您的服务器IP。但是，自动检测可能会产生错误的结果，尤其是在网络设置复杂的情况下。如果您将Che作为云服务器运行，即可供外部用户访问，我们建议明确提供外部IP CHE_HOST。

打开Che

打开浏览器，在浏览器中输入http://${your ip}:${your port}来打开Eclipse Che，出现如下内容则安装成功

1. 默认管理员账号：admin；密码：admin，第一次使用admin登录是会要求修改admin密码
2. 多用户可以点击Register来注册用户账号
3. 管理员可登录http://<your-ip>:5050来管理多用户