在Bluehost VPS的WHM/cPanel环境下安装OpenProject遇错求助

1. 解决PostgreSQL btree_gist 扩展缺失错误 #

该错误源于系统缺少OpenProject依赖的PostgreSQL扩展组件，按以下步骤修复：

步骤1：安装对应版本的PostgreSQL contrib包 #

先确认PostgreSQL版本：

psql --version

根据输出的版本号安装对应contrib包，例如版本为15时执行：

dnf install postgresql15-contrib -y

（将15替换为你的实际PostgreSQL版本号，如14、16）

步骤2：在OpenProject数据库中创建扩展 #

登录PostgreSQL并切换到目标数据库：

su - postgres
psql -d your_openproject_database_name

执行创建扩展命令：

CREATE EXTENSION btree_gist;

完成后退出：

\q
exit

步骤3：重新运行OpenProject数据库迁移 #

在WHM终端执行：

openproject run rake db:migrate

2. 解决子域名访问无内容问题 #

步骤1：确认OpenProject的web配置 #

重新运行配置向导验证FQDN设置：

openproject reconfigure

确保配置过程中FQDN项设置为projects.example.dev，并确认web服务器（Apache/Nginx）的配置路径正确。

步骤2：检查cPanel子域名的文档根目录映射 #

登录WHM进入dev账户的cPanel，找到子域名管理：

• 确认projects.example.dev的文档根目录指向OpenProject的web文件目录（可通过openproject config show查看OPENPROJECT_PUBLIC_PATH的值，通常为/opt/openproject/public）
• 若路径不匹配，修改子域名的文档根目录为正确路径

步骤3：重启web服务 #

使用Apache时执行：

systemctl restart httpd

使用Nginx时执行：

systemctl restart nginx

步骤4：检查防火墙与SELinux设置 #

允许80/443端口流量：

firewall-cmd --add-service=http --permanent
firewall-cmd --add-service=https --permanent
firewall-cmd --reload

若SELinux启用，设置文件上下文：

semanage fcontext -a -t httpd_sys_content_t "/opt/openproject/public(/.*)?"
restorecon -Rv /opt/openproject/public

完成以上操作后，重新访问projects.example.dev即可正常加载OpenProject页面。

内容的提问来源于stack exchange，提问作者rudtek