OpenProject Docker 镜像部署指南：slim 与 all-in-one 镜像变体、配置项与容器架构解析

OpenProject Docker 镜像部署指南slim 与 all-in-one 镜像变体、配置项与容器架构解析【免费下载链接】openprojectOpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with agile planning, issue tracking, roadmaps, Gantt charts, time tracking, collaboration features, and more. Available on premises or in the cloud. ⭐ Star us on GitHub项目地址: https://gitcode.com/GitHub_Trending/op/openproject本文围绕 OpenProject 官方仓库docker/prod/目录发布的 Docker 镜像体系展开系统讲解 OpenProject 两种镜像变体外部数据库用的slim镜像与开箱即用的all-in-one镜像的差异、镜像标签规则、Docker Compose / 单容器 / Helm 三种部署路径并结合 Dockerfile 与容器启动脚本深入解析关键环境变量、数据持久化与多进程调度架构。读完本文你将能够根据生产环境形态外部 PostgreSQL 还是内置数据库、是否需要 BIM 支持、是否需要 Kubernetes正确选择镜像变体、配置容器并理解容器内部的完整运行链路。一、镜像体系总览两种变体、两类使用场景OpenProject 在 Docker Hub 上发布的镜像分两种变体对应完全不同的部署模型。官方文档docker/prod/README.md给出的定义如下变体标签形式定位适用场景slim应用容器dev-slim、MAJOR-slim、MAJOR.MINOR-slim、MAJOR.MINOR.PATCH-slim仅包含 OpenProject 应用不含数据库需要外部 PostgreSQL 与反向代理Docker Compose、Kubernetes / Helm Charts、生产系统all-in-one一体化容器dev、MAJOR、MAJOR.MINOR、MAJOR.MINOR.PATCH应用 PostgreSQL Apache 反向代理 Memcached 后台任务 协作文档服务全部打包快速体验、单机快速起步官方明确建议生产系统推荐使用slim镜像因为数据库、缓存、代理等组件应由专门的进程或集群组件承载便于独立扩缩容与运维all-in-one镜像的意义在于一条命令把 OpenProject 跑起来适合评估试用或小规模部署。值得注意的是在 Dockerfile 中两种变体都默认设置ENV OPENPROJECT_EDITIONstandard并注明合法取值为standard与bim。其中slim-bim是一个额外公开的构建目标Dockerfile它与slim完全相同只是通过ENV OPENPROJECT_EDITIONbim启用了 BIM建筑信息模型功能支持——需要在镜像构建期安装 XKT 转换器、COLLADA2GLTF、IfcConvert、xeokit-metadata 等 BIM 工具链见 setup/preinstall-common.sh。二、镜像构建链与标签规则从 Dockerfile 可以看出镜像采用多阶段构建最终产出 4 个公开目标slim应用容器外部数据库Dockerfileslim-bim启用 BIM 的 slim 应用容器Dockerfileall-in-one一体化容器Dockerfileapp-build/app-runtime等为中间构建阶段不直接发布镜像发布时的标签遵循语义化版本规则主版本MAJOR如15次版本MAJOR.MINOR如15.1补丁版本MAJOR.MINOR.PATCH如15.1.0dev开发分支滚动构建官方同时指出所有镜像统一发布在 Docker Hub 的openproject/openproject仓库下按标签可查日常拉取时可根据锁定策略选择MAJOR跟随次版本更新或MAJOR.MINOR.PATCH完全锁定级别的标签。构建期的关键版本参数Dockerfile 通过 ARG 声明了构建参数镜像构建者可用--build-arg覆盖ARG默认值说明RUBY_VERSION4.0.6基础镜像的 Ruby 版本作用于ruby:${RUBY_VERSION}-slim-trixieDEBIAN_BASEtrixieDebian 发行版代号NODE_VERSION24.19.0前端构建与 BIM 运行时所需的 Node 版本NPM_VERSION11.19.0npm 版本注释说明 Node 自带 npm 的补丁滞后故单独指定BIM_SUPPORTtrue是否在构建阶段安装 BIM 工具链三、部署方式一Docker Compose官方推荐slim镜像的核心使用方式是配合外部 PostgreSQL、反向代理组成 Compose 或 Kubernetes 栈。仓库根目录提供了 docker-compose.yml 与 docker-compose.override.example.yml 作为编排参考。Compose 部署的典型形态包含web服务使用openproject/openproject:MAJOR-slim镜像暴露 8080 端口slim 镜像在 Dockerfile 中EXPOSE 8080worker服务同一镜像覆盖启动命令执行后台任务db服务PostgreSQL 容器数据目录挂载持久卷proxy由 Apache 反向代理slim 镜像内的 proxy 脚本与 proxy.conf.erb 模板负责生成站点配置处理 HTTPS 终止与静态资源。应用容器通过DATABASE_URL环境变量指向外部数据库web启动脚本 docker/prod/web 支持以下控制变量变量默认值作用BIND0.0.0.0Rails 服务器监听地址PORT8080监听端口RAILS_ENVdevelopment运行环境生产请显式设为production设为 production 时会自动开启OPENPROJECT_ENABLE__INTERNAL__ASSETS__SERVERtrue由 Puma 直接服务静态资源MIGRATEfalse设为true时启动前自动执行rake db:migrate# docker-compose.yml 精简示意实际以仓库根目录文件为准 services: web: image: openproject/openproject:15-slim ports: - 8080:8080 environment: - DATABASE_URLpostgres://openproject:openprojectdb:5432/openproject - RAILS_ENVproduction - SECRET_KEY_BASE替换为强随机密钥 - OPENPROJECT_HOST__NAMEopenproject.example.com volumes: - opdata:/var/openproject/assets depends_on: - db worker: image: openproject/openproject:15-slim command: ./docker/prod/worker environment: - DATABASE_URLpostgres://openproject:openprojectdb:5432/openproject volumes: - opdata:/var/openproject/assets db: image: postgres:17 environment: - POSTGRES_USERopenproject - POSTGRES_PASSWORDopenproject volumes: - pgdata:/var/lib/postgresql/data volumes: opdata: pgdata:worker脚本docker/prod/worker内部使用bundle exec good_job start启动基于 GoodJob 的后台任务队列若传入--seed参数则会先调用 docker/prod/seeder 完成种子数据初始化适合首次部署时执行。四、部署方式二单容器 all-in-one快速起步all-in-one镜像面向一条命令跑起来的场景。它比 slim 多了以下内建组件见 Dockerfile内置 PostgreSQL数据目录PGDATA/var/openproject/pgdata通过VOLUME暴露持久化内置 MemcachedOPENPROJECT_RAILS__CACHE__STOREmemcache内置 Apache 反向代理EXPOSE 80内置 Hocuspocus 协同编辑服务从openproject/hocuspocus:17.8.0复制而来用于 OpenProject 的实时协作编辑能力默认数据库连接DATABASE_URLpostgres://openproject:openproject127.0.0.1/openproject。启动命令非常简单docker run -d \ -p 8080:80 \ -e SECRET_KEY_BASE替换为强随机密钥 \ -v /var/lib/openproject/pgdata:/var/openproject/pgdata \ -v /var/lib/openproject/assets:/var/openproject/assets \ openproject/openproject:15首次启动时入口脚本 entrypoint.sh 会依次完成检测/初始化 PostgreSQL 数据簇通过 postgres-db-init 调用initdb→ 启动临时数据库实例 → 执行rake db:migrate与rake db:seed→ 停止临时实例 → 用erb渲染 supervisord.conf.erb 为 supervisord 配置 → 交给 supervisord 统一拉起全部进程。首次安装完成后的默认管理员账号为admin/admin见 docker/prod/supervisord 中的启动提示。all-in-one 的进程编排架构从 supervisord.conf.erb 可以看到 supervisord 管理的进程及优先级进程优先级说明apache22Apache 反向代理proxy 脚本启动渲染 proxy.conf.erb 站点配置web4Rails/Puma Web 服务./docker/prod/webworker5GoodJob 后台任务队列./docker/prod/workerhocuspocus6协同编辑服务./docker/prod/hocuspocusmemcached100缓存服务postfix100邮件发送服务cron100IMAP 收信轮询默认不自动启动postgres1内置数据库仅当DATABASE_URL指向127.0.0.1时才由 ERB 条件渲染启动这种一个容器、supervisord 调度多进程的架构正是 all-in-one 镜像开箱即用的实现基础而 slim 镜像则把上述职责拆分到 Compose/Kubernetes 的不同服务中。五、部署方式三Helm ChartsKubernetes 推荐对于 Kubernetes 环境官方推荐使用 Helm Charts 部署slim镜像。仓库中提供了 Helm 生态相关的配套文件docker/prod/artifacthub-repo.ymlArtifactHub 仓库元数据与 artifacthub-repo-update.shArtifactHub 元数据同步脚本说明该镜像体系与 Helm 分发链路是官方持续维护的一等公民。Helm 部署的核心思路与 Compose 一致webDeployment 使用slim镜像、worker使用同一镜像启动 worker 命令、数据库与缓存改用集群内托管的 PostgreSQL / Memcached、Ingress 接管 TLS。因为slim镜像本身不捆绑数据库与代理天然适配 Kubernetes 的每个容器只跑一个职责模型这也是官方将其标注为生产推荐的原因之一。六、关键环境变量与配置项全解以下变量在 Dockerfile 与入口脚本中定义是容器化配置 OpenProject 的核心入口。OpenProject 遵循OPENPROJECT_KEY形式的环境变量映射到openproject-key配置的规则双下划线__代表嵌套层级。6.1 运行环境与密钥变量默认值说明RAILS_ENVproductionRails 环境生产部署保持默认SECRET_KEY_BASEOVERWRITE_ME必须覆盖。用于会话与签名Dockerfile 明确注释请在生产环境提供安全值DockerfileRAILS_LOG_TO_STDOUT1日志输出到标准输出便于容器日志采集RAILS_SERVE_STATIC_FILES1由 Rails 直接提供静态文件6.2 实例与存储变量默认值说明OPENPROJECT_EDITIONstandard合法值standard/bimslim-bim镜像预设为bimOPENPROJECT_INSTALLATION__TYPEdocker安装类型标记OPENPROJECT_ATTACHMENTS__STORAGE__PATH/var/openproject/assets/files附件存储目录entrypoint 也兼容旧变量ATTACHMENTS_STORAGE_PATHentrypoint.shOPENPROJECT_RAILS__CACHE__STOREfile_storeslim /memcacheall-in-one缓存后端OPENPROJECT_ANGULAR_UGLIFYtrue前端资源压缩6.3 主机名、HTTPS 与协同编辑变量默认值说明OPENPROJECT_HOST__NAME默认localhost对外访问域名用于生成链接与 Hocuspocus URLOPENPROJECT_HTTPS-是否启用 HTTPS决定 Hocuspocus 使用wss还是ws协议OPENPROJECT_COLLABORATIVE__EDITING__HOCUSPOCUS__URLautoauto表示自动使用镜像内置的 Hocuspocus置空则关闭内置服务可在 UI 中另行配置外部地址OPENPROJECT_COLLABORATIVE__EDITING__HOCUSPOCUS__SECRET空Hocuspocus 共享密钥设为auto时由 entrypoint.sh 自动生成 32 位随机密钥字符集限定为字母数字以保证 YAML 安全解析6.4 数据库与 PostgreSQL 相关变量默认值说明DATABASE_URLall-in-one 默认postgres://openproject:openproject127.0.0.1/openproject数据库连接串指向外部库时 all-in-one 不初始化本地数据库簇PGVERSION17主用 PostgreSQL 版本容器内置 13/15/17 三个客户端版本PGVERSION_CHOICESPGDATA/var/openproject/pgdata数据目录仅 all-in-one值得注意的细节当以 root 启动并检测到PGDATA下已存在 PostgreSQL 数据簇时entrypoint.sh 会读取PG_VERSION文件自动将PGVERSION/PGBIN切换到与既有数据一致的版本并在版本不匹配时给出升级提示例如迁移到 PostgreSQL 17避免因版本错配导致无法启动。6.5 内存分配与后台任务变量默认值说明USE_JEMALLOCfalse设为true时通过LD_PRELOADlibjemalloc.so.2启用 jemalloc 内存分配器entrypoint-slim.sh对高并发内存分配场景有优化价值PG_STARTUP_WAIT_TIME10all-in-one 等待 PostgreSQL 就绪的重试次数SUPERVISORD_LOG_LEVELinfosupervisord 日志级别七、容器生命周期与数据持久化7.1 入口脚本的两条路径slim 镜像使用 entrypoint-slim.sh只做两件事——按USE_JEMALLOC预加载分配器、按PGVERSION设置PGBIN与PATH然后exec $执行用户命令默认./docker/prod/web。它不负责数据库初始化完全依赖外部数据库。all-in-one 镜像使用 entrypoint.sh具备更完整的能力——旧版卷路径兼容性检查如检测到/var/db/openproject等遗留路径会报错退出并提示新路径、数据目录所有权修复对 NAS 快照目录.snapshot做剪枝处理、Apache 站点目录授权、PID 文件清理、root 权限降级通过setpriv --reuid app以及以root为前缀执行任意命令的运维逃生通道entrypoint.sh。7.2 必须持久化的卷镜像卷容器内路径slim应用数据卷/var/openproject/assetsAPP_DATA_PATH含files、git、svn子目录见 entrypoint.shall-in-one数据库卷 应用数据卷/var/openproject/pgdata、/var/openproject/assetsDockerfile此外setup/postinstall-common.sh 在镜像构建期预先创建了/tmp/op_uploaded_files/并清理重建tmp/目录确保 Puma 以非 1000 的 UID 运行时仍能创建 PID 与临时上传文件——这也是自定义容器安全上下文如 OpenShift 任意 UID时需要注意的落盘点。7.3 数据库初始化与升级all-in-one 首次启动的数据库初始化流程docker/prod/supervisord若DATABASE_URL为空或指向127.0.0.1则configure_local_postgres准备本地数据簇必要时pg_createclusterPGDATA/PG_VERSION不存在时调用 postgres-db-init 以initdb初始化数据簇并创建openproject超级用户与同名数据库启动临时 PostgreSQL → 执行rake db:migrate与rake db:seed以app用户执行保证附件归属正确→ 停止临时实例若通过PLUGIN_GEMFILE_URL指定了自定义 Gemfile还会在迁移前拉取并执行bundle install、前端npm install与assets:precompile实现容器内插件热安装docker/prod/supervisord最后渲染 supervisord 配置并正式启动全部进程。7.4 运维辅助命令all-in-one 容器支持以root前缀执行一次性命令常见运维操作示例# 进入 Rails 控制台对应 docker/prod/console 脚本bundle exec rails c docker exec -it 容器名 root ./docker/prod/console # 手动执行数据库迁移 docker exec -it 容器名 root bundle exec rake db:migrate # 执行种子数据 docker exec -it 容器名 root ./docker/prod/seederslim容器同理直接覆盖 command 即可例如# 在 slim 容器中执行迁移后启动 webMIGRATEtrue 由 web 脚本内置支持 docker run openproject/openproject:15-slim ./docker/prod/web # 配合 MIGRATEtrue 环境变量八、IMAP 邮件接收cron 服务all-in-one 镜像中的cron进程docker/prod/cron实现了周期性的 IMAP 收信并把邮件转换为工作包/讨论的机制。supervisord 中该进程仅在IMAP_ENABLEDtrue时启动supervisord.conf.erb。# 核心收信循环默认每 600 秒轮询一次 bundle exec rake redmine:email:receive_imap \ host${IMAP_HOST} \ username${IMAP_USERNAME} \ password${IMAP_PASSWORD} \ ssl${IMAP_SSL} \ port${IMAP_PORT} \ folder${IMAP_FOLDER} \ project${IMAP_ATTR_PROJECT} \ category${IMAP_ATTR_CATEGORY} \ priority${IMAP_ATTR_PRIORITY} \ status${IMAP_ATTR_STATUS} \ version${IMAP_ATTR_VERSION} \ type${IMAP_ATTR_TYPE} \ assigned_to${IMAP_ATTR_ASSIGNED_TO} \ unknown_user${IMAP_UNKNOWN_USER} \ no_permission_check${IMAP_NO_PERMISSION_CHECK} \ move_on_success${IMAP_MOVE_ON_SUCCESS} \ move_on_failure${IMAP_MOVE_ON_FAILURE} \ allow_override${IMAP_ALLOW_OVERRIDE}常用控制变量及默认值IMAP_ENABLEDtrue、IMAP_SSLtrue、IMAP_SSL_VERIFICATIONtrue、IMAP_PORT993、IMAP_CHECK_INTERVAL600秒。IMAP_ATTR_*系列变量用于为收到的邮件设置默认的项目、分类、优先级、状态、版本、类型与负责人等属性IMAP_UNKNOWN_USER、IMAP_MOVE_ON_SUCCESS/IMAP_MOVE_ON_FAILURE等则控制未知发件人策略与邮件移动行为。九、从源码理解镜像的设计取舍综合 Dockerfile 与各启动脚本可以提炼出镜像体系的几个设计要点slim 优先的工程取向多阶段构建中专门有prune-slim-runtime.shdocker/prod/setup/prune-slim-runtime.sh对 slim 运行时做裁剪去掉构建期依赖而BIM_SUPPORT相关工具链只进入标准非 slim 裁剪运行时避免非 BIM 用户背负无谓体积。这与官方生产环境用 slim的建议互为印证。数据库版本兼容策略PGVERSION_CHOICES13 15 17同时安装多个 PostgreSQL 客户端版本配合 entrypoint 对既有数据簇版本的自动探测允许旧数据卷在新镜像上继续以原版本运行平滑过渡到升级。配置以环境变量为唯一入口OpenProject 的OPENPROJECT_*环境变量体系贯穿 Web、Worker、Cron 全部进程容器层不提供额外配置文件确保同一镜像在不同编排平台Compose、K8s、裸 Docker上的配置方式完全一致。可组合性all-in-one的 supervisord 配置通过 ERB 模板按DATABASE_URL是否指向本机动态决定是否托管 PostgreSQLweb/worker/cron都是独立可执行脚本因此slim镜像可以灵活地以不同 command 扮演不同角色为 Compose/Kubernetes 的水平扩展如独立扩展 worker 数量留出了空间。十、结论与选型建议回到 docker/prod/README.md 给出的官方路径部署选型可以归纳为评估/试用、个人单机all-in-oneopenproject/openproject:MAJOR一条命令即可体验完整功能正式生产传统环境slim Docker Compose外部 PostgreSQL 反向代理 独立 worker正式生产容器平台slim Helm Charts交给 Kubernetes 编排BIM 场景选用slim-bim或 all-in-one 配合OPENPROJECT_EDITIONbim。无论选择哪条路径都需要在生产环境中严格落实两件事一是将SECRET_KEY_BASE覆盖为高强度的随机值二是持久化/var/openproject/assetsslim以及/var/openproject/pgdataall-in-one数据卷避免容器重建造成数据丢失。更深入的部署细节可在仓库 docker-compose.yml、Dockerfile 与docker/prod/下的各启动脚本中继续追查验证。【免费下载链接】openprojectOpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with agile planning, issue tracking, roadmaps, Gantt charts, time tracking, collaboration features, and more. Available on premises or in the cloud. ⭐ Star us on GitHub项目地址: https://gitcode.com/GitHub_Trending/op/openproject创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考