一、云服务器配置
- 操作系统:Alibaba Cloud Linux 3.2104 LTS 64位
- CPU & 内存:2 核(vCPU)4 GiB
二、Codes简介
Codes 是国内首个重新定义 SaaS 模式的开源项目管理平台,支持云端与本地部署,功能全面且免费开放。为 20 人以下团队免费提供敏捷研发解决方案,集需求、任务、测试、缺陷、文档、统计于一体,助力高效协同与精益开发。
三、安装
Linux系统下,Codes提供了两种安装方式:
- 基于 Docker Compose 的一键安装(推荐)
- 纯 Docker 安装
1. 环境准备
1、更新系统包
sql
sudo yum update -y
2、安装 Docker 依赖
kotlin
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
3、添加Docker阿里云镜像源
arduino
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
4、安装Docker
lua
yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
5、启动 Docker 服务并设置开机自启
bash
sudo systemctl start docker
sudo systemctl enable docker
6、验证 Docker 是否安装成功
css
docker --version
如果输出 Docker 版本号,说明安装成功 ✅
7、安装 Docker Compose
bash
curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
docker-compose version
2. 安装Codes
1、基于 Docker Compose 的一键安装 Codes
以 root 用户 执行以下命令(不要使用 sudo):
arduino
curl -s https://download.icodes.work/codes_scripts/codes_base_3.6.0GAu1_install_upgrade_on_docker-compose.sh -o install_codes.sh && bash install_codes.sh
安装过程中会提示:
- 选择安装目录
- 设置端口
- 指定服务器 IP 地址
安装目录和商品号按回车即可,访问IP地址会自动检测,如果是想要的IP按回车即可,如果不是想要的IP需要手动修改然后按回车。
安装成功后,控制台会输出访问地址。在浏览器中打开Codes访问地址,会自动跳转到激活页,需要用注册的租户ID来激话。
如何取租户ID:登录 Codes 官网以注册的租户登录,在帐户设置中可拷租户ID。
至此,Codes就安装成功了。
四、常用维护命令
bash
# 停止 Codes
docker-compose -f $CODES_HOME/docker-compose.yml down
# 启动 Codes
docker-compose -f $CODES_HOME/docker-compose.yml up -d
# 查看日志
docker logs --tail=100 -f codes_web_server
五、附录
1. 修改内存
当云服务器内存不是那么大时,我们可能需要为Codes设置环境变量指定 JVM 内存限制。
1、打开docker-compose.yml文件
bash
vim $CODES_HOME/docker-compose.yml
2、在 codes_web_server 服务中添加环境变量
找到 services 下的 codes_web_server 配置,添加 environment 字段,示例:
ruby
codes_web_server:
image: registry.cn-zhangjiakou.aliyuncs.com/codes_work/codes_serve:3.6.0GAu2
# 其他配置...
environment:
- CATALINA_OPTS=-XX:+UseContainerSupport -XX:MaxRAMPercentage=75.0 -Xms512m -Xmx1024m -XX:MaxMetaspaceSize=512m

3、重启服务使配置生效
bash
cd $CODES_HOME
docker compose -f docker-compose.yml down
docker compose -f docker-compose.yml up -d
2. 配置域名
为 Codes 配置域名访问,需要完成 域名解析设置 和 服务器内反向代理配置 两步。
1、登录域名管理平台,配置域名解析。
略!!!
2、服务器内配置反向代理
通过 Nginx 将域名请求转发到 Codes 容器的端口。
安装Nginx
bash
sudo yum install -y nginx
# 启动并设置开机自启
sudo systemctl start nginx
sudo systemctl enable nginx
创建 Nginx 配置文件
bash
# 新建 Codes 域名配置文件
sudo vim /etc/nginx/conf.d/codes.conf
配置反向代理(HTTP 版本)
perl
server {
listen 80;
server_name codes.example.com; # 替换为你的域名
# 将请求转发到 Codes 容器的 8010 端口
location / {
proxy_pass http://127.0.0.1:8010; # 指向本地 Codes 容器端口
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
验证配置并重启 Nginx
bash
# 检查配置是否有误
sudo nginx -t
# 重启 Nginx 生效
sudo systemctl restart nginx