聚合DNS管理系统 (DNSMgr) - WDH 虚拟主机部署指南

参考文档：

• 原项目地址：https://github.com/netcccyun/dnsmgr

• 参考博文 (Serv00版)：https://blog.notett.com/post/2025/12/251228-s00-dns/

🛠️ 准备工作

1. WDH 账号：拥有一个可用的 Web Hosting 实例（Plesk 面板）。

2. 域名：已解析到 WDH 服务器 IP（推荐使用 Cloudflare）。

3. 源码下载：
• 请务必下载 Release 发行版（包含完整依赖），不要直接下载 Source code。
• 下载地址：DNSMgr Releases (推荐 v2.15)

🚀 部署步骤

1. 创建数据库

1. 登录 Plesk 面板，点击 Bases de données (数据库)。

2. 点击 Ajouter une base de données。

3. 设置数据库名、用户名和密码。
• 注意：请记下这些信息，稍后安装时需要。

2. 上传源码

1. 进入 Gestionnaire de fichiers (文件管理器)。

2. 进入 httpdocs 目录。

3. 上传下载好的 .zip 压缩包并解压。

4. 检查结构：确保 app, public, thinkphp, vendor 等文件夹直接位于 httpdocs 根目录下。

3. 环境配置 (WDH 关键设置)

1. 回到面板首页，点击 Hébergement (主机设置)。

2. 文档根目录 (Document Root)：修改为 httpdocs/public。

3. PHP 版本：建议选择 8.0 或 8.1。

4. SSL 证书：进入 Certificats SSL/TLS，申请 Let's Encrypt 免费证书。

💣 避坑指南 (常见错误修复)

坑位 1：打开网站报错 500 (权限问题)

• 现象：ThinkPHP 无法写入日志或缓存。

• 解决方法：
1. 在文件管理器中找到根目录下的 runtime 文件夹。
2. 点击修改权限。
3. 务必勾选 “Replace permission entries recursively” (递归修改)。
4. 给所有用户（User, Group, Others）勾选 Write (写入) 权限（即 777 权限）。

坑位 2：报错 Option FollowSymlinks not allowed here (伪静态冲突)

• 现象：查看 logs/error_log 发现大量此错误，网站打不开。

• 原因：WDH 是共享主机，出于安全考虑禁止了 .htaccess 中的 FollowSymLinks 指令。

• 解决方法：Apache
1. 编辑 httpdocs/public/.htaccess 文件。
2. 找到 Options +FollowSymlinks。
3. 将其替换为 Options +SymLinksIfOwnerMatch。
4. 或者直接使用以下代码覆盖：
<IfModule mod_rewrite.c> # WDH 必须使用 SymLinksIfOwnerMatch Options +SymLinksIfOwnerMatch -Multiviews RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L] </IfModule>

坑位 3：提示数据库连接失败 / 无法进入安装页面

• 现象：手动修改了 .env 文件后，页面报错提示找不到 {dbhost}。

• 原因：手动复制的 .env 文件包含占位符，导致程序误以为已安装但配置错误。

• 解决方法：
1. 删除 根目录下的 .env 文件。
2. 直接访问域名，程序会自动跳转到安装向导界面。
3. 在网页界面填写数据库信息（Host 填 localhost 或 127.0.0.1）。

坑位 4：Cloudflare 重定向次数过多

• 现象：浏览器提示 ERR_TOO_MANY_REDIRECTS。

• 原因：Plesk 强制开启了 HTTPS，但 Cloudflare SSL 模式为 Flexible。

• 解决方法：
1. 登录 Cloudflare 后台 -> SSL/TLS。
2. 将模式改为 Full (完全) 或 Full (Strict)。

✅ 完成安装

1. 访问您的域名 https://your-domain.com。

2. 进入安装向导，填写数据库信息和管理员账号。

3. 点击安装，尽情享用！

📅 定时任务 (可选)

• 命令：/opt/plesk/php/8.1/bin/php /var/www/vhosts/你的域名/httpdocs/think certtask

• (注意：具体 PHP 路径和项目路径请根据 WDH 面板实际情况调整)