团队工单不想上 SaaS？Docker 跑个 Redmine，浏览器就能管项目

本文基于 library/redmine:6.0.10 与 library/mysql:8.0-debian 镜像，Ubuntu 24.04 服务器实测

团队用 Jira、禅道、飞书项目，数据不在自己手里？Redmine 是一款开源、可自托管的项目管理与问题跟踪系统——支持 工单、甘特图、Wiki、版本库、时间跟踪，Docker Compose 双容器（Redmine + MySQL）即可跑通。浏览器打开就能建项目、派任务、看进度，数据全在你自己的服务器上。

本文带你完成一次 Redmine Docker Compose 私有化部署：轩辕镜像加速拉取、编写 docker-compose.yml、处理 3000 端口冲突、读懂启动日志，到浏览器 admin 登录、强制改密、切换中文、载入默认配置、新建第一个项目——全程零基础可跟做，文末附 7 张实测截图。

国内用户从 Docker Hub 拉取 library/redmine 可能较慢，本文使用 轩辕镜像 加速域 docker.xuanyuan.run。官方镜像说明见 Docker Hub - redmine，项目官网 redmine.org。

---

一、Redmine 是什么？

Redmine 是一款 开源、自托管的项目管理与问题跟踪（Issue Tracking）系统，基于 Ruby on Rails，GPL 许可。核心能力：

典型使用场景：

• 小团队 私有工单系统，替代 Jira / 禅道 SaaS
• 开发团队 Bug 跟踪 + 版本里程碑 + Git 变更关联
• 内部 项目进度与文档 Wiki 统一入口

与 Memos / File Browser 的区别：Redmine 不能单容器跑生产环境，官方镜像默认依赖 MySQL / PostgreSQL（不配数据库会回退 SQLite，仅适合临时试用）。本文采用 Redmine + MySQL 双容器 Compose，数据持久化到宿主机目录。

---

二、环境要求

验证 Docker：

bash
docker --version
docker compose version

若尚未安装 Docker，可使用轩辕镜像一键脚本：

bash
bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

更多安装说明见 轩辕镜像使用手册。

---

三、拉取镜像

Redmine 与 MySQL 均需从轩辕镜像加速域拉取：

bash
docker pull docker.xuanyuan.run/library/redmine:6.0.10
docker pull docker.xuanyuan.run/library/mysql:8.0-debian

成功时终端显示 Status: Downloaded newer image for ...。

部署前预检（确认 MySQL 镜像能在本机 CPU 上运行）：

bash
docker run --rm docker.xuanyuan.run/library/mysql:8.0-debian mysql --version

若报 CPU does not support x86-64-v2，须改用 mysql:8.0-debian（勿用默认 mysql:8.0 标签）。详见 MySQL 镜像老旧 CPU 兼容说明。

---

四、创建目录并编写 Compose

工作目录使用 /www/wwwroot/redmine（独立目录，勿与其他项目混用）：

bash
mkdir -p /www/wwwroot/redmine/{files,mysql}
cd /www/wwwroot/redmine

4.1 生成 SECRET_KEY

Redmine 会话加密密钥 必填，用 OpenSSL 生成：

bash
openssl rand -hex 64

将输出填入下方 REDMINE_SECRET_KEY_BASE（每次部署应使用不同值）。

4.2 编写 docker-compose.yml

bash
vim docker-compose.yml

完整内容（与 Ubuntu 24.04 实测一致，请将密码改为强密码）：

yaml
name: redmine

services:
  redmine:
    image: docker.xuanyuan.run/library/redmine:6.0.10
    container_name: redmine
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "8080:3000"
    environment:
      REDMINE_DB_MYSQL: db
      REDMINE_DB_DATABASE: redmine
      REDMINE_DB_USERNAME: redmine
      REDMINE_DB_PASSWORD: YourStrongPass123
      REDMINE_SECRET_KEY_BASE: 请粘贴_openssl_rand_输出
      TZ: Asia/Shanghai
    volumes:
      - ./files:/usr/src/redmine/files

  db:
    image: docker.xuanyuan.run/library/mysql:8.0-debian
    container_name: redmine-db
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: RootPass456
      MYSQL_DATABASE: redmine
      MYSQL_USER: redmine
      MYSQL_PASSWORD: YourStrongPass123
      TZ: Asia/Shanghai
    volumes:
      - ./mysql:/var/lib/mysql
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-uroot", "-pRootPass456"]
      interval: 10s
      timeout: 5s
      retries: 10

各参数说明：

密码一致性：REDMINE_DB_PASSWORD 必须与 MYSQL_PASSWORD 相同；healthcheck 中的 root 密码须与 MYSQL_ROOT_PASSWORD 一致。

---

五、启动服务

bash
docker compose up -d

首次启动 MySQL 初始化约 20～30 秒，Redmine 自动执行数据库迁移约 1～3 分钟。

查看状态：

bash
docker compose ps

期望输出（Ubuntu 24.04 实测）：

text
NAME         IMAGE                                          STATUS                        PORTS
redmine      docker.xuanyuan.run/library/redmine:6.0.10     Up                            0.0.0.0:8080->3000/tcp
redmine-db   docker.xuanyuan.run/library/mysql:8.0-debian   Up (healthy)                  3306/tcp

查看 Redmine 日志：

bash
docker compose logs -f redmine

首次启动日志中会出现大量 Writing ...（静态资源预编译）与 Migrating to ...（数据库迁移），属正常现象。日志末尾出现 Puma 监听即表示就绪：

text
* Listening on tcp://0.0.0.0:3000

另开终端快速探测：

bash
curl -I http://127.0.0.1:8080

应返回 HTTP 200 或 302。

日志提示：可能出现 Your Gemfile lists the gem puma ... more than once 或 jQuery 资源 WARN，为官方镜像已知提示，不影响使用，可忽略。

---

六、浏览器访问与登录

在浏览器打开（将 YOUR_SERVER_IP 换成服务器 IP）：

text
http://YOUR_SERVER_IP:8080

6.1 首页欢迎页

首次访问会看到 Redmine 默认欢迎页，右上角有 「登录」 与 「注册」 链接：

图 1：部署成功后的 Redmine 首页，确认 Web 服务已就绪

6.2 使用默认账号登录

点击右上角 「登录」，输入默认管理员账号：

图 2：Redmine 默认管理员账号为 admin / admin

安全提示：默认密码 admin 仅用于首次登录。Redmine 会在登录后 强制要求修改密码，公网暴露前务必完成改密。

6.3 强制修改密码

首次登录后，页面顶部出现红色提示：「您的密码已经过期或是管理员要求您修改密码。」 填写当前密码 admin 与新密码（至少 8 个字符），点击 「应用」：

图 3：首次登录强制改密，新密码至少 8 位

6.4 我的账号

改密成功后进入 「我的帐号」 页面，顶部绿色提示 「密码更新成功」。可在此修改 语言（选 简体中文）、邮件通知、时区等：

图 4：改密成功后的个人账号设置页

---

七、初始化与功能验证

以下步骤确认 Redmine 不仅「能登录」，还能完成项目管理常见操作。

7.1 载入默认配置（推荐）

顶部导航点击 「管理」，页面提示角色、跟踪标签、问题状态与工作流尚未配置。语言选 「Chinese/Simplified (简体中文)」，点击 「载入默认设置」：

图 7：管理后台载入默认配置，一键初始化角色与工作流

这一步会导入 Redmine 预设的 角色、跟踪标签（Bug/功能/支持等）、问题状态、工作流，省去手动逐项配置的麻烦。

7.2 新建第一个项目

顶部 「项目」→「新建项目」（或 「+ 新建项目」），填写：

下方 模块 可勾选问题跟踪、Wiki、甘特图、版本库等，点击 「创建」：

图 5：创建第一个项目，启用所需功能模块

7.3 我的工作台

顶部 「我的工作台」 进入个人仪表盘，可查看 指派给我的问题、已报告的问题 等区块。右侧 「新增:」 下拉可添加更多面板（更新的问题、日历、活动等）：

图 6：登录后的个人工作台，可自定义仪表盘区块

至此，拉镜像 → Compose 启动 → admin 登录 → 改密 → 载入默认配置 → 新建项目 → 工作台 全流程验证完成。

---

八、常用环境变量速查

摘自 Docker Hub - redmine 环境变量：

容器内 Redmine 监听 3000 端口，宿主机映射在 Compose ports 中配置。

---

九、常见问题 FAQ

Q1：启动报 failed to bind host port 0.0.0.0:3000/tcp: address already in use？

宿主机 3000 端口已被占用（常见为 Node 应用或其他容器）。修改 docker-compose.yml 中 ports：

yaml
    ports:
      - "8080:3000"

然后重新启动：

bash
docker compose up -d

浏览器访问 http://服务器IP:8080。可用 ss -tlnp | grep ':3000' 查看占用进程。

Q2：Redmine 一直启动中 / 浏览器 502？

数据库尚未就绪。先确认 redmine-db 为 (healthy)：

bash
docker compose ps
docker compose logs db

待 MySQL 就绪后 Redmine 会继续迁移，首次约 1～3 分钟。可 docker compose logs -f redmine 观察迁移进度。

Q3：默认账号 admin / admin 无法登录？

全新安装应可用。若数据库目录 mysql/ 来自旧部署，可能已改过密码。可清空 mysql/ 与 files/ 后重新 docker compose up -d（会丢失全部数据），或通过 Rails 控制台重置密码。

Q4：数据存在哪里？

删除这两个目录会丢失全部项目与工单，升级镜像时请勿删除。

Q5：如何升级 Redmine？

bash
cd /www/wwwroot/redmine
docker pull docker.xuanyuan.run/library/redmine:6.0.10
docker compose up -d

跨大版本升级前建议备份 files/ 与 mysql/ 目录。

Q6：如何切换界面为中文？

我的帐号 → 语言 → 简体中文（zh）→ 保存。全站默认语言可在 管理 → 配置 → 一般 → 语言 中设置。

Q7：日志里 Gemfile / jQuery 警告需要处理吗？

不需要。puma gem listed more than once 与 Unable to resolve ... jquery 为官方镜像已知输出，不影响 Redmine 正常运行。

Q8：如何停止与卸载？

bash
# 停止容器（保留 files / mysql 数据）
cd /www/wwwroot/redmine && docker compose down

# 删除数据目录（慎用，项目与工单将全部丢失）
rm -rf /www/wwwroot/redmine/files /www/wwwroot/redmine/mysql

Q9：可以用宝塔已有 MySQL 吗？

可以。去掉 Compose 中的 db 服务，将 REDMINE_DB_MYSQL 改为宿主机 MySQL 地址（容器访问宿主机常用 172.17.0.1），并确保 MySQL 中已建库、用户及授权。仅保留 Redmine 单容器即可。

Q10：生产环境如何对外发布？

建议 Nginx / Caddy 反向代理 到 127.0.0.1:8080，配置 HTTPS；在 管理 → 配置 → 一般 中设置 主机名称 为你的域名。8080 仅内网监听，不对公网直连。

---

十、命令速查

---

十一、延伸阅读

---

总结：Redmine = 私有化项目与工单管理，需 Redmine + MySQL 双容器。个人或小团队用 第四节 Compose 方案，浏览器 admin 登录 → 改密 → 载入默认配置 → 新建项目 即可上手；长期运行请配合 数据备份 与 反向代理 HTTPS，项目数据完全在自己服务器上。