本教程适用于以下操作系统版本
- Debian 12 (Bookworm)
- Debian 11 (Bullseye)
- Debian 10 (Buster)
本页内容
- 准备工作
- 安装 OpenProject
- 配置 OpenProject
- 访问 OpenProject
OpenProject 是一款用 Ruby on Rails 和 AngularJS 编写的项目管理软件。它主要是 ChiliProject 的一个分支,而 ChiliProject 又源自 Redmine。它可以用于跨团队和部门的项目管理,并提供丰富的功能,例如敏捷与 Scrum、缺陷跟踪、Wiki、论坛、任务管理、团队协作、项目路线图以及版本发布管理。
本教程将引导你在 Debian 12 服务器上完成 OpenProject 项目管理软件的安装。你将使用 PostgreSQL 作为数据库后端,并使用 Apache 作为反向代理来搭建 OpenProject。
准备工作
在开始之前,请确保满足以下要求:
- 一台至少配备 4GB 内存的 Debian 12 服务器
- 一个拥有 sudo 权限的非 root 用户
- 一个已指向你服务器 IP 地址的域名
让我们开始吧。
安装 OpenProject
OpenProject 是一款免费且开源的项目管理软件,同时支持传统与敏捷两种项目管理模式。它可以帮助你跟踪项目的整个生命周期。该软件支持 30 多种语言,并提供免费版和付费订阅版两种版本。
OpenProject 可以通过多种方式安装,例如使用包管理器或在 Kubernetes 等容器环境中安装。对于 Ubuntu、Debian、CentOS 等大多数 Linux 发行版,OpenProject 提供了二进制软件包,你可以通过包管理器轻松安装。
首先,使用以下命令为你的 Debian 系统安装基础依赖。输入 y 确认安装。
sudo apt install apt-transport-https ca-certificates wget gpg

现在,运行下面的命令添加 OpenProject 仓库的 GPG 密钥。
wget -qO- https://dl.packager.io/srv/opf/openproject/key | gpg --dearmor > /etc/apt/trusted.gpg.d/packager-io.gpg
然后,使用以下命令为 Debian 12 版本添加 OpenProject 仓库。
wget -O /etc/apt/sources.list.d/openproject.list \
https://dl.packager.io/srv/opf/openproject/stable/13/installer/debian/12.repo

添加 GPG 密钥和仓库后,运行以下命令更新你的 Debian 软件包列表。你将看到 OpenProject 仓库已被添加。
sudo apt update

现在,你可以使用下面的 apt 命令将 OpenProject 软件包安装到 Debian 系统中。输入 Y 继续安装。
sudo apt install openproject

安装完成后,你将看到如下提示信息。

配置 OpenProject
现在你已经安装了 OpenProject,可以开始通过命令行对其进行配置。系统默认会创建 openproject 命令行工具,允许你从终端 shell 配置 OpenProject。
openproject 命令允许你以交互方式完成 OpenProject 的安装配置,你可以设置 PostgreSQL、Apache Web 服务器、Memcached,并配置 Git/SVN 集成。
要配置 OpenProject,请执行下面的 openproject 命令。这将以交互方式从 shell 完成 OpenProject 的配置。
sudo openproject configure
选择 OpenProject 版本为 default(默认版)。默认版用于通用项目管理,而 bim 版本则面向建筑行业等特定行业领域。

选择 Install the new PostgreSQL(安装新的 PostgreSQL),将其作为 OpenProject 安装的数据库。

当被询问时,选择 Install Apache web server(安装 Apache Web 服务器)。你将使用 Apache 作为 OpenProject 的反向代理。

现在输入你的 OpenProject 安装的域名。

安装路径保持留空。你将在根域名/子域名下安装 OpenProject。

对于 SSL 配置,选择 Yes 或 No。你需要提供 SSL 证书的相关信息。

跳过 Subversion 仓库集成。

你也可以为 OpenProject 安装 Git 集成。

输入 Git 仓库的路径目录。默认情况下,它将使用 /var/db/subversion/git 目录。

Git CGI 后端路径保持默认即可。

选择 Install memcached server(安装 memcached 服务器)以继续。

现在输入你的 OpenProject 安装的管理员邮箱地址。

然后,选择默认语言为 English(英语)。

流程结束后,你将看到如下内容:

通过下面的命令,你可以查看 PostgreSQL、Apache 和 Memcached 服务的状态。请确保这三个服务都在运行。
sudo systemctl status postgresql apache2 memcached

最后,使用以下命令检查 OpenProject 相关服务。请确保所有服务都处于运行状态。
sudo systemctl status openproject openproject-web openproject-worker

访问 OpenProject
打开你的网页浏览器,访问 http://project.howtoforge.local/login。你将看到 OpenProject 的登录页面。输入默认用户名 admin 和密码 admin,然后点击 Sign In(登录)。

现在,将默认管理员密码修改为一个强度更高的新密码,然后点击 Save(保存)确认。

流程完成后,你将看到类似如下的 OpenProject 仪表盘:

你可以通过内置的演示项目,查看基于 Scrum 的传统与敏捷项目管理功能。