Ir al contenido

文档03:部署、安全与启动

针对本地权限分配、不可变秘密生成和Redmine堆栈可控启动的战术流程和安全最佳实践。

0阅读

与测试环境的其他文件系统不同,企业 Linux 环境中容器内挂载的卷要求严格的所有权和权限分配以保障安全。Redmine 的内部引擎在隔离的系统用户下运行其线程,该用户的标识符(UID/GID)为 999。

如果在Ubuntu主机上未更改所有权,应用程序将启动,但< strong >在尝试上传附件、编译自定义样式表或转储日志跟踪时会< /strong >立即失败,导致数据库中出现无声异常。

在初始化基础设施之前,请在主机终端的工作目录中运行权限清理命令:

Ventana de terminal
cd ~/redmine
# Saneamiento recursivo de carpetas expuestas al contenedor
sudo chown -R 999:999 files themes plugins mysql_data config

[!WARNING]\n访问安全:在任何情况下,都不要在这些企业环境文件夹上设置 chmod -R 777 这类宽松的全球权限。如果某个 Redmine 插件存在安全漏洞,这将为远程文件注入打开严重的攻击向量。


Redmine 使用声明式密钥 SECRET_KEY_BASE,将客户端 cookie 中的会话令牌加密存储。为防止会话劫持或浏览器中的恶意截获,该密钥必须具有高熵,且保持完全不可变和保密。

如果未来因定期网络安全审计需要重新生成密钥,请运行加密安全的随机命令:

Ventana de terminal
openssl rand -hex 64

复制生成的字母数字字符串,并在重启整个栈之前在 docker-compose.yml 文件中立即更新 SECRET_KEY_BASE 变量。


要编译、构建隔离网络依赖项和以守护进程模式(后台)启动持久化容器:

Ventana de terminal
cd ~/redmine
docker compose up -d

Docker Compose将自动创建虚拟网络,挂载配置的卷,并等待MySQL数据库引擎准备好初始化Redmine的SQL结构。


通过战术调试命令确保服务正确启动:

Ventana de terminal
docker compose ps

成功标准:两个容器(redmine 和 redmine_db)均应显示状态 Up 或 healthy。

为了分析数据库初始化过程和Rails执行的内部表迁移:

Ventana de terminal
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 初始化完成前立即启动。