文档03:部署、安全与启动
针对本地权限分配、不可变秘密生成和Redmine堆栈可控启动的战术流程和安全最佳实践。
1. 权限管理(Linux中的关键步骤)
Sección titulada «1. Gestión de Permisos (Paso Crítico en Linux)»与测试环境的其他文件系统不同,企业 Linux 环境中容器内挂载的卷要求严格的所有权和权限分配以保障安全。Redmine 的内部引擎在隔离的系统用户下运行其线程,该用户的标识符(UID/GID)为 999。
如果在Ubuntu主机上未更改所有权,应用程序将启动,但< strong >在尝试上传附件、编译自定义样式表或转储日志跟踪时会< /strong >立即失败,导致数据库中出现无声异常。
在初始化基础设施之前,请在主机终端的工作目录中运行权限清理命令:
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedorsudo chown -R 999:999 files themes plugins mysql_data config[!WARNING]\n访问安全:在任何情况下,都不要在这些企业环境文件夹上设置
chmod -R 777这类宽松的全球权限。如果某个 Redmine 插件存在安全漏洞,这将为远程文件注入打开严重的攻击向量。
2. 不可变秘密生成(Rails会话)
Sección titulada «2. Generación Inmutable de Secretos (Sesiones Rails)»Redmine 使用声明式密钥 SECRET_KEY_BASE,将客户端 cookie 中的会话令牌加密存储。为防止会话劫持或浏览器中的恶意截获,该密钥必须具有高熵,且保持完全不可变和保密。
如果未来因定期网络安全审计需要重新生成密钥,请运行加密安全的随机命令:
openssl rand -hex 64复制生成的字母数字字符串,并在重启整个栈之前在 docker-compose.yml 文件中立即更新 SECRET_KEY_BASE 变量。
要编译、构建隔离网络依赖项和以守护进程模式(后台)启动持久化容器:
cd ~/redminedocker compose up -dDocker Compose将自动创建虚拟网络,挂载配置的卷,并等待MySQL数据库引擎准备好初始化Redmine的SQL结构。
通过战术调试命令确保服务正确启动:
docker compose ps成功标准:两个容器(redmine 和 redmine_db)均应显示状态 Up 或 healthy。
为了分析数据库初始化过程和Rails执行的内部表迁移:
docker compose logs -f redmine预期输出:在日志流的末尾查找活动套接字记录:\nListening on 0.0.0.0:3000(其已外部映射到企业安全端口 5588)。
- 常见原因:
- 主机共享目录缺少所有者权限(遗漏了
chown命令)。 docker-compose.yml的 YAML 文件存在语法缩进错误。
- 主机共享目录缺少所有者权限(遗漏了
- 解决方案:停止引擎(
docker compose down),使用docker compose logs检查套接字的详细错误日志,然后使用chown -R 999:999重新执行权限修复。
- 常见原因:
- 变量
REDMINE_DB_MYSQL中指定的名称与 Compose 文件中声明的服务名称不完全一致。
- 变量
- 解决方案:打开编排文件,检查两者是否使用统一的 DNS 标识符:
redmine_db。
- ✓ 正确的文件所有权:所有挂载目录均配置为 UID/GID
999,以避免写入异常。 - ✓ 健壮的会话密钥:使用 OpenSSL 生成的
SECRET_KEY_BASE变量,并与公共环境隔离。 - ✓ 活动的网络套接字:安全映射到端口
5588,并通过 Rails 日志重定向正确响应。 - ✓ 耦合编排:通过
depends_on指令锁定主应用服务,使其不会在 MySQL 初始化完成前立即启动。

