云服务器安装Codes免费项目管理平台

原创

汪小成

修改于 2025-10-21 11:05:32

130

一、云服务器配置

CPU & 内存：**2** 核（vCPU）**4** GiB

二、Codes简介

Codes 是国内首个重新定义 SaaS 模式的开源项目管理平台，支持云端与本地部署，功能全面且免费开放。为 20 人以下团队免费提供敏捷研发解决方案，集需求、任务、测试、缺陷、文档、统计于一体，助力高效协同与精益开发。

三、安装

Linux系统下，Codes提供了两种安装方式：

基于 Docker Compose 的一键安装（推荐）
纯 Docker 安装

1. 环境准备

1、更新系统包

sudo yum update -y

2、安装 Docker 依赖

sudo yum install -y yum-utils device-mapper-persistent-data lvm2

3、添加Docker阿里云镜像源

yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

4、安装Docker

yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

5、启动 Docker 服务并设置开机自启

sudo systemctl start docker

sudo systemctl enable docker

6、验证 Docker 是否安装成功

docker --version

如果输出 Docker 版本号，说明安装成功 ✅

7、安装 Docker Compose

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）：

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就安装成功了。

四、常用维护命令

# 停止 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文件

vim $CODES\_HOME/docker-compose.yml

2、在 codes_web_server 服务中添加环境变量

找到 services 下的 codes_web_server 配置，添加 environment 字段，示例：

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、重启服务使配置生效

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

sudo yum install -y nginx



# 启动并设置开机自启

sudo systemctl start nginx

sudo systemctl enable nginx

创建 Nginx 配置文件

# 新建 Codes 域名配置文件

sudo vim /etc/nginx/conf.d/codes.conf

配置反向代理（HTTP 版本）

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

# 检查配置是否有误

sudo nginx -t



# 重启 Nginx 生效

sudo systemctl restart nginx

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

后端

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

后端

登录后参与评论

0 条评论

热度