在DigitalOcean Ubuntu22 CloudPanel中创建子域名及配置故障解决指南

1. 先确认DNS记录生效 #

你已添加CNAME记录，先验证是否生效：

• 登录VPS终端，执行命令：

  dig your-subdomain.your-domain.com CNAME
  

  或用nslookup：

  nslookup your-subdomain.your-domain.com
  

  确保返回的目标地址是你的主域名或VPS公网IP，刚添加的记录可能需要10-30分钟生效，耐心等待TTL刷新。

2. 通过CloudPanel面板添加子域名（推荐，无需手动找配置文件） #

CloudPanel是可视化管理面板，不需要手动操作site-available这类传统目录，步骤如下：

• 打开CloudPanel后台：访问https://你的VPS公网IP:8443（首次登录需设置管理员账号）
• 左侧菜单栏点击Websites，进入网站列表页
• 点击右上角的Add Website按钮
• 填写网站信息：
  • Domain：输入你的子域名（比如blog.your-domain.com）
  • PHP Version：根据网站类型选择（静态站选Static，PHP项目选对应版本）
  • Document Root：默认public，按需调整
  • 勾选Enable SSL（自动生成Let's Encrypt证书），其他选项保持默认
• 点击Create，面板会自动生成Nginx配置并重启服务，等待1-2分钟即可访问

3. 手动编辑配置文件（若需自定义规则） #

如果必须手动修改配置，CloudPanel生成的Nginx配置文件路径如下：

• 系统级配置目录：/etc/nginx/sites-enabled/
• 对应子域名的配置文件名称：your-subdomain.your-domain.com.conf

编辑命令示例：

nano /etc/nginx/sites-enabled/your-subdomain.your-domain.com.conf

修改完成后，重启Nginx服务生效：

systemctl restart nginx

4. 常见访问问题排查 #

• 防火墙端口未开放：检查UFW防火墙状态：

  ufw status
  

  若80/443端口未开放，执行：

  ufw allow 80/tcp
  ufw allow 443/tcp
  

• SSL证书问题：如果访问提示证书错误，进入CloudPanel的网站详情页，点击SSL选项卡重新生成证书
• 网站根目录无内容：确保/home/cloudpanel/htdocs/your-subdomain.your-domain.com/public目录下有index.html/index.php等入口文件

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