OpenProject 自托管项目管理：Docker 部署与 10 分钟上手教程-编程实验室

OpenProject 自托管项目管理：Docker 部署与 10 分钟上手教程

【免费下载链接】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 命令就能在自己服务器上架好，项目、工作包、甘特图、工时记录都在这一个系统里，数据完全留在自己手里。

它是什么，适合谁

OpenProject 覆盖项目管理的主要场景：项目与组合管理、任务跟踪、敏捷看板、甘特图、路线图、工时和成本。社区版免费，功能完整，适合把数据主权放在第一位的组织。

适合：

想把项目管理工具部署在内网、数据不出服务器的小到中团队
从 Jira、MS Project 等工具迁出，或不想按席位付费的团队
需要甘特图、工时、自定义字段这类"重"功能的交付型团队

不太适合：

只想装个桌面客户端、没有任何服务器的人（它是服务端应用，没有单机版）
追求开箱即用云服务的团队——那更适合直接用官方托管版，省去运维

功能清单和版本差异可以在安装与运维文档里查到。

最短路径：从 0 到可用

最省心的方式是用官方的 all-in-one Docker 镜像，它把 PostgreSQL 和缓存都装在同一个容器里，不需要单独搭数据库。详细原理见 Docker 安装指南。

准备密钥：容器启动需要一个随机的SECRET_KEY_BASE，用来加密会话和数据库内容。生成一次后妥善保存，之后每次启动都要用同一个值。

openssl rand -hex 64

启动容器：以下命令以后台方式启动，把容器 80 端口映射到本机 8080。

docker run -d --name openproject -p 8080:80 \ -e SECRET_KEY_BASE=<上一步生成的密钥> \ -e OPENPROJECT_HOST__NAME=localhost:8080 \ -e OPENPROJECT_HTTPS=false \ openproject/openproject:17

取初始密码：首次启动需要几分钟做数据库初始化，完成后终端日志会打印默认的admin管理员密码。

docker logs -f openproject

浏览器访问：打开http://localhost:8080，用 admin 加日志里的密码登录，按提示改密码即完成部署。

另外两种方式是 Docker Compose（每组件一个容器，适合生产）和 Kubernetes Helm 部署，本机跑通后再考虑迁移。

第一次使用：10 分钟动线

按"新建项目→建任务→看进度"走一遍，十分钟能熟悉主要界面。

第一步：新建项目。登录后点右上角 New，选择 Project，填项目名称即可创建；描述、模块等都可以之后在设置里补。

第二步：建第一个任务。进入项目，在 Work Packages 标签点 New，填写标题，指定负责人、截止日期和类型（任务、缺陷、里程碑等），保存。之后可以在详情页改状态、记工时。

第三步：看进度。把几个任务都建好后，切到项目里的甘特图视图，任务条按日期排开，拖拽可调整时间，也可以连线设置任务依赖。

项目成员的邀请和角色分配在 Administration → Members 里完成，支持按项目授权。

三个真正影响效率的配置

状态流：让"进行到哪一步"不用问

场景：任务状态全靠自由填写，"进行中"和"做完了"边界模糊，评审时一堆口头确认。
操作：Administration → Workflow，选定工作包类型后，在状态矩阵里勾选允许的状态转换，以及哪些角色能触发转换。
效果：任务只能沿你定义的路径流转，列表里一眼能看出谁卡在哪一步。

角色权限：按人收放数据可见范围

场景：新成员一进来就能看到所有项目和成本字段，而外部顾问只需要看自己负责的模块。
操作：Administration → Roles 里复制出角色（如"顾问"），关掉 View work packages、View costs 等不需要的权限；再到项目的 Members 页把人挂到对应角色上。
效果：权限按角色管理而不是按人改，加新成员时选个角色即可。

保存常用视图：甘特图不用每次重新过滤

场景：每次汇报前都要手动按负责人、状态过滤一遍甘特图，参数全靠记忆。
操作：在甘特图里设好过滤器和列之后，点 Save as view 存成一个团队视图。
效果：成员打开项目直接选这个视图，看到的都是同一口径的进度。

踩坑与排障

容器起不来，日志报密钥相关错误原因：SECRET_KEY_BASE用了默认值或太弱，或者两次启动用了不同的值。处理：用openssl rand -hex 64重新生成一个，把它写进启动命令并存档；值变了，旧会话和加密内容会读不出来。

重启容器后数据全没了原因：all-in-one 镜像的数据库和上传文件都存在容器内部，没挂卷的话删容器即丢数据。处理：按官方文档挂载两个卷：-v /var/lib/openproject/pgdata:/var/openproject/pgdata存数据库，-v /var/lib/openproject/assets:/var/openproject/assets存附件；目录归属问题（macOS 常见 "Operation not permitted"）把目录建在用户主目录下即可。备份时导出 pgdata 卷并打包 assets 卷。

浏览器被反复跳到 HTTPS，本地访问打不开原因：镜像默认强制 HTTPS，本机 HTTP 访问会被重定向；同时OPENPROJECT_HOST__NAME没填成浏览器里实际看到的地址，链接和登录回跳会异常。处理：本地环境加-e OPENPROJECT_HTTPS=false，并把OPENPROJECT_HOST__NAME设为localhost:8080（或你的实际域名）；上了外网反向代理后去掉该变量、由代理做 TLS 终结。

下一步：在你自己的机器上执行上面的 docker run，把第一个项目建出来；生产化部署时再读安装 FAQ 和运维指南补上数据卷与反向代理。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考