当前位置：

文章详情

一键部署私有项目管理：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 许可。核心能力：

能力说明多项目管理每个项目独立模块：工单、Wiki、文档、版本库、讨论区问题跟踪自定义跟踪标签、状态、工作流；支持甘特图、日历权限与角色细粒度角色权限，支持 LDAP 认证时间跟踪记录工时、生成报表插件生态大量社区插件扩展功能

典型使用场景：

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

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

二、环境要求

项目建议操作系统Linux（本文 Ubuntu 24.04）Docker已安装 Docker 与 Docker Compose V2内存≥ 2 GB（Redmine + MySQL 双容器；推荐 4 GB）CPU双核即可；老旧 VPS 注意 MySQL 镜像兼容性（见第三节）磁盘≥ 5 GB（镜像 + 数据库 + 附件）端口8080（宿主机映射，容器内 Redmine 监听 3000）

验证 Docker：

docker --version docker compose version

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

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

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

三、拉取镜像

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

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 上运行）：

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 兼容说明。

官方镜像轩辕镜像加速拉取说明redmine:6.0.10docker.xuanyuan.run/library/redmine:6.0.10本文主镜像，固定小版本redmine:6.0docker.xuanyuan.run/library/redmine:6.06.0 系列滚动标签mysql:8.0-debiandocker.xuanyuan.run/library/mysql:8.0-debian老旧 CPU 首选mysql:8.0docker.xuanyuan.run/library/mysql:8.0勿用（Oracle Linux 9，需 x86-64-v2）

四、创建目录并编写 Compose

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

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

宿主机目录容器内路径用途files//usr/src/redmine/filesRedmine 附件与上传文件mysql//var/lib/mysqlMySQL 数据库数据

4.1 生成 SECRET_KEY

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

openssl rand -hex 64

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

4.2 编写 docker-compose.yml

vim docker-compose.yml

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

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

各参数说明：

参数说明8080:3000宿主机 8080 → 容器 3000（Redmine Web 端口）REDMINE_DB_MYSQL: db数据库主机名为 Compose 服务名 dbREDMINE_DB_*Redmine 连接 MySQL 的库名、用户、密码REDMINE_SECRET_KEY_BASE会话加密密钥，必填MYSQL_*MySQL 初始化：root 密码、业务库与用户depends_on + healthcheck等 MySQL 就绪后再启动 Redmine./files / ./mysql附件与数据库 宿主机持久化

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

五、启动服务

docker compose up -d

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

查看状态：

docker compose ps

期望输出（Ubuntu 24.04 实测）：

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 日志：

docker compose logs -f redmine

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

* Listening on tcp://0.0.0.0:3000

另开终端快速探测：

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

http://YOUR_SERVER_IP:8080

6.1 首页欢迎页

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

picture.image

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

6.2 使用默认账号登录

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

字段值登录名admin密码admin

picture.image

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

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

6.3 强制修改密码

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

picture.image

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

6.4 我的账号

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

picture.image

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

七、初始化与功能验证

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

7.1 载入默认配置（推荐）

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

picture.image

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

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

7.2 新建第一个项目

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

字段示例名称测试App项目标识app（小写字母、数字、短横线，保存后不可改）公开勾选（内网可见；外网建议取消）

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

picture.image

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

7.3 我的工作台

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

picture.image

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

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

八、常用环境变量速查

摘自 Docker Hub - redmine 环境变量：

变量默认用途REDMINE_DB_MYSQL—MySQL 主机名（与 REDMINE_DB_POSTGRES 互斥）REDMINE_DB_PORT3306数据库端口REDMINE_DB_USERNAMEroot数据库用户名REDMINE_DB_PASSWORD—数据库密码REDMINE_DB_DATABASEredmine数据库名REDMINE_SECRET_KEY_BASE—会话加密密钥，生产必填REDMINE_PLUGINS_MIGRATE—设为 true 时启动时执行插件迁移

容器内 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：

ports: - "8080:3000"

然后重新启动：

docker compose up -d

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

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

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

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：数据存在哪里？

路径内容/www/wwwroot/redmine/files/附件、上传文件/www/wwwroot/redmine/mysql/MySQL 全部数据

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

Q5：如何升级 Redmine？

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：如何停止与卸载？

# 停止容器（保留 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 仅内网监听，不对公网直连。

十、命令速查

操作命令拉取镜像docker pull docker.xuanyuan.run/library/redmine:6.0.10拉取 MySQLdocker pull docker.xuanyuan.run/library/mysql:8.0-debian生成密钥openssl rand -hex 64Compose 启动cd /www/wwwroot/redmine && docker compose up -d查看状态docker compose ps查看日志docker compose logs -f redmine健康检查curl -I http://127.0.0.1:8080Web 访问http://服务器IP:8080默认账号admin / admin（首次登录后强制改密）停止服务docker compose down

十一、延伸阅读

主题链接Redmine 官网https://www.redmine.org官方 Wikihttps://www.redmine.org/projects/redmine/wikiDocker Hub 镜像https://hub.docker.com/_/redmine轩辕 Redmine 镜像页https://xuanyuan.cloud/zh/r/library/redmine轩辕 MySQL 镜像页https://xuanyuan.cloud/zh/r/library/mysql轩辕镜像https://xuanyuan.cloud

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