【开源项目】彩虹聚合DNS管理系统部署全平台高效管理多域名实操指南

• 文件传输工具：FileZilla（免费）、WinSCP，用于上传安装包到服务器；
• 服务器操作工具：PuTTY（Windows）、终端（Linux/Mac）、Xshell（付费，功能更全），用于执行命令；
• 域名平台账号：需提前获取各平台的 “AccessKey ID” 和 “AccessKey Secret”（从平台 “访问控制” 页面生成，需勾选 “域名解析管理” 权限）；
• Composer（可选）：仅下载 “Source code 包” 时需安装，用于安装 PHP 依赖；若下载 Release 页面的 “已打包安装包”，无需准备。

1. 访问彩虹聚合 DNS 管理系统的 Release 页面（可通过官方渠道获取链接）；
2. 选择安装包类型：
   • 推荐新手下载 “已打包安装包”（文件名通常含 “release”，无需 Composer 安装依赖）；
   • 技术型站长若需自定义代码，可下载 “Source code（zip/tar.gz）”。

1. 通过 FileZilla 连接服务器，将安装包上传到网站根目录（如 Linux 的 “/var/www/html/”、Windows 的 “C:\inetpub\wwwroot\”）；
2. 解压安装包：
   • Linux 系统：登录终端，进入根目录，执行unzip 安装包文件名.zip（若提示 “unzip: command not found”，先执行yum install unzip或apt-get install unzip安装工具）；
   • Windows 系统：直接右键解压，或通过远程桌面操作。

• 设置运行目录：
  系统基于 ThinkPHP 框架开发，必须将网站运行目录指定为解压后文件夹中的 “public” 目录。
  以宝塔面板为例：进入 “网站”→“管理”→“网站目录”，将 “运行目录” 选择为 “public”，勾选 “防跨站攻击（open_basedir）”，点击保存。
• 配置伪静态规则：
  根据服务器类型（Nginx/Apache）添加对应规则，确保 URL 重写正常。

  • Nginx 服务器：
    进入服务器的 Nginx 配置文件（通常在 “/etc/nginx/conf.d/ 网站域名.conf”），在 “server {}” 节点内添加：

    location / {
        if (!-e $request_filename){
            rewrite  ^(.*)$  /index.php?s=$1  last;   break;
        }
    }

  • 添加后执行nginx -t检查配置是否正确，无错误则执行systemctl restart nginx重启 Nginx。

  • Apache 服务器：
    在网站根目录（public 的上级目录）找到 “.htaccess” 文件（若没有则新建），添加：

    <IfModule mod_rewrite.c>
      Options +FollowSymlinks -Multiviews
      RewriteEngine On
    
      RewriteCond %{REQUEST_FILENAME} !-d
      RewriteCond %{REQUEST_FILENAME} !-f
      RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
    </IfModule>

    保存后执行systemctl restart httpd（Linux）或在 “服务” 中重启 Apache（Windows）。

1. 安装 Composer：执行curl -sS https://getcomposer.org/installer | php，再执行mv composer.phar /usr/local/bin/composer实现全局调用；
2. 进入系统根目录（非 public 目录），执行composer install --no-dev，等待依赖安装完成（需确保服务器网络通畅，过程约 1-5 分钟）。

1. 在浏览器中输入服务器 IP 或已绑定的域名（如 “http://192.168.1.100”），系统会自动跳转到安装页面；
2. 环境检测：页面会自动检测 PHP 版本、MySQL 连接、文件夹权限，若有 “红色警告”（如文件夹无写入权限），按提示修改（Linux 执行chmod -R 755 系统目录赋予权限）；
3. 数据库配置：输入 MySQL 的 “主机地址”（默认localhost）、“数据库名”（需提前在 MySQL 中创建）、“用户名”“密码”，点击 “下一步”；
4. 管理员设置：填写 “管理员用户名”“密码”（建议包含大小写字母 + 数字 + 符号，提高安全性），点击 “安装”；
5. 安装完成后，点击 “进入后台”，输入账号密码即可登录。

• Linux 系统（以 CentOS 为例）：
  1. 卸载旧版本（若有）：yum remove docker docker-client docker-common docker-latest；
  2. 安装依赖：yum install -y yum-utils device-mapper-persistent-data lvm2；
  3. 添加 Docker 仓库：yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo；
  4. 安装并启动：yum install docker-ce -y → systemctl start docker → systemctl enable docker（设置开机自启）；
• Windows/Mac 系统：
  下载 Docker Desktop（官网：https://www.docker.com/products/docker-desktop/），按向导安装，启动后在终端执行docker --version，显示版本即安装成功。

docker run --name dnsmgr -dit -p 8081:80 -v /var/dnsmgr:/app/www netcccyun/dnsmgr

• 命令说明：
  • --name dnsmgr：给容器命名为 “dnsmgr”，方便后续管理；
  • -p 8081:80：将服务器 8081 端口映射到容器 80 端口（若 8081 被占用，可改为 “8082:80” 等未占用端口）；
  • -v /var/dnsmgr:/app/www：将服务器 “/var/dnsmgr” 目录挂载到容器，实现数据持久化（避免容器删除后配置丢失）。

1. 在浏览器输入 “服务器 IP:8081”（如 “http://123.45.67.89:8081”），按常规部署的 “系统安装” 步骤完成数据库配置和管理员设置；
2. 若安装后 “容灾切换” 功能未自动启动，执行docker restart dnsmgr重启容器即可。

在/docker/dnsmgr目录下创建docker-compose.yml，内容如下：

version: '3'
services:
  dnsmgr-web:
    container_name: dnsmgr-web
    stdin_open: true
    tty: true
    ports:
      - 8081:80  # 服务器端口:容器端口，可自定义
    volumes:
      - ./web:/app/www  # 数据持久化目录
    image: netcccyun/dnsmgr
    depends_on:
      - dnsmgr-mysql  # 依赖MySQL服务
    networks:
      - dnsmgr-network

  dnsmgr-mysql:
    container_name: dnsmgr-mysql
    restart: always  # 自动重启
    ports:
      - 3306:3306  # MySQL端口
    volumes:
      - ./mysql/conf/my.cnf:/etc/mysql/my.cnf  # 配置文件挂载
      - ./mysql/logs:/logs  # 日志挂载
      - ./mysql/data:/var/lib/mysql  # 数据挂载
    environment:
      - MYSQL_ROOT_PASSWORD=123456  # MySQL root密码，建议修改
      - TZ=Asia/Shanghai  # 时区设置
    image: mysql:5.7  # MySQL版本
    networks:
      - dnsmgr-network

networks:
  dnsmgr-network:
    driver: bridge

[mysqld]
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci

1. 登录后台，左侧 “功能导航” 点击 “域名账户”→“+ 添加”；
2. 选择 “所属平台”（如阿里云），填写该平台的 “AccessKey ID” 和 “AccessKey Secret”（从平台 “访问控制 - API 密钥管理” 中获取，需确保权限包含 “域名解析”）；
3. 填写 “备注”（如 “企业官网账户”），方便区分，点击 “保存”；
4. 保存后，若 “状态” 显示 “正常”，说明对接成功；若显示 “异常”，需核对 AccessKey 是否正确、服务器是否能访问平台 API（可通过 “ping api.aliyun.com” 测试连通性）。

1. 左侧点击 “域名管理”→“+ 添加”；
2. 选择 “平台账户”（即上一步添加的账户），输入域名（如 “www.abc.com”），点击 “保存”；
3. 添加后，在 “域名管理列表” 中可查看域名的 “记录数”（解析记录数量）、“对接开关”（是否启用系统管理）；
4. 若需隐藏域名（仅管理员可见），点击 “配置”→勾选 “是否隐藏”→“保存”。

• 添加 / 修改解析：
  1. “域名管理列表” 找到目标域名，点击 “解析” 进入解析页面；
  2. 点击 “+ 添加记录”：
     • 主机记录：填 “www”（对应 www 域名）、“@”（对应主域名）、“*”（泛域名）；
     • 记录类型：A 记录（指向 IP）、CNAME（指向域名，如 CDN 地址）、MX（邮件解析）等；
     • 线路类型：默认（所有用户）、电信 / 联通 / 移动（分运营商）；
     • 记录值：A 记录填服务器 IP，CNAME 填目标域名（如 “xxx.cdn.com”）；
     • TTL：建议设为 300-900 秒（解析生效更快）；
  3. 点击 “保存”，解析记录实时同步到对应平台。
• 批量操作：
  勾选多个解析记录，点击 “批量操作” 可实现 “批量启用 / 禁用”“批量删除”，适合批量更换解析目标（如服务器迁移时）。
• 容灾配置（关键）：
  1. 域名解析页面点击 “配置”→“容灾切换”→“开启”；
  2. 选择 “检测协议”：推荐 “http (s)”（直接检测网站是否可访问），填写 “检测地址”（如 “https://www.abc.com”）；
  3. 设置 “检测间隔”（如 60 秒）、“失败阈值”（如 3 次，连续 3 次检测失败触发容灾）；
  4. 选择 “容灾动作”：
     • 自动暂停解析：适合临时故障，避免用户访问错误地址；
     • 自动修改解析：填写备用记录值（如备用服务器 IP），故障时自动切换；
  5. 勾选 “通知方式”（邮件 / 微信公众号），点击 “保存”，容灾功能生效。

1. 左侧点击 “CF 优选 IP”→“+ 添加优选 IP 任务”；
2. 选择 “CDN 服务商” 为 “CloudFlare”，“域名选择” 为目标域名；
3. 配置参数：
   • 解析 IP 类型：IPv4（A 记录）或 IPv6（AAAA 记录，根据服务器支持选择）；
   • 解析线路类型：如 “电信 / 联通 / 移动”（分运营商优化）；
   • 每线路解析数量：建议 2-3 个（避免单点故障）；
   • TTL：设为 600 秒；
4. 点击 “提交”，系统会自动抓取最新优选 IP 并更新解析记录；
5. 在 “任务管理” 中可查看任务状态，若需停止任务，点击 “停止” 即可。

1. 左侧点击 “用户管理”→“+ 添加用户”；
2. 填写 “用户名”“密码”，选择 “用户等级”：
   • 普通用户：仅管理指定域名，需在 “域名权限” 中勾选可管理的域名；
   • 管理员：拥有全部权限，适合团队负责人；
3. 若需给用户开启 API 接口（用于对接 IDC 系统），勾选 “开启 API 接口”，系统会自动生成 “API 密钥”；
4. 点击 “保存”，用户可使用账号登录，按权限管理域名。

• 原因：AccessKey 错误、权限不足、服务器无法访问平台 API；
• 解决：
  1. 核对 AccessKey 是否正确（注意区分 “AccessKey ID” 和 “AccessKey Secret”）；
  2. 检查 AccessKey 权限：进入平台 “访问控制 - 权限管理”，确保已添加 “AliyunDNSFullAccess”（阿里云）、“QcloudDNSFullAccess”（腾讯云）等域名解析权限；
  3. 测试服务器与平台 API 的连通性：执行 “ping api.aliyun.com”（阿里云）、“ping dnspod