Vagrant：虚拟机启动时无法加载符号链接的Nginx配置

环境信息确认 #

• Vagrant 2.0.1
• Vagrant Box: ubuntu/xenial64
• 配置工具: Ansible
• 补全后合理推测的Vagrantfile内容：

Vagrant.configure("2") do |config|
  config.vm.box = "ubuntu/xenial64"
  config.vm.box_download_insecure = true
  config.vm.define "foobar"
  config.vm.provider "virtualbox" do |provider|
    provider.name = "foobar"
    provider.customize [ "modifyvm", :id, "--uartmode1", "disconnected" ]
  end
  config.vm.network "private_network", ip: "192.168.5.4"
  config.vm.hostname = "foobar.dev"
  config.hostsupdater.aliases = ["pma.foobar.dev"]
end

问题排查与解决方案 #

虚拟机启动时Nginx无法加载符号链接配置，通常是路径、权限、语法或执行顺序的问题，咱们一步步解决：

1. 检查Nginx的配置加载规则

Ubuntu Xenial上的Nginx默认只会加载/etc/nginx/sites-enabled/目录下的配置（通过/etc/nginx/nginx.conf里的include /etc/nginx/sites-enabled/*;指令）：

• 先确认你的符号链接是否在这个目录里，如果不在，要么把链接移过去，要么修改nginx.conf添加对应的include指令；
• 执行sudo nginx -t命令，它会帮你检查配置的语法和路径问题，直接输出错误位置，是排查这类问题的首选工具。

2. 验证符号链接的有效性

符号链接本身没问题，但指向的源文件可能出状况：

• 确保源配置文件真实存在，且用绝对路径指向（相对路径容易让Nginx找不到），执行ls -l /etc/nginx/sites-enabled/your-site-link可以查看链接指向的具体路径；
• 检查权限：Nginx的运行用户是www-data，必须有读取源配置文件的权限，执行ls -l /path/to/your-source-config.conf查看权限，必要时用sudo chmod 644 /path/to/your-source-config.conf调整为可读权限。

3. 检查配置文件语法

即使链接正常，源文件的语法错误也会导致Nginx拒绝加载：

• 还是用sudo nginx -t命令，它会精准指出哪个文件的哪一行有语法错误，比如括号不闭合、指令拼写错误等，修复后再尝试重启Nginx。

4. 确保Ansible配置任务正确

如果是Ansible负责创建符号链接，检查你的playbook任务：

• 用file模块创建链接时，必须指定绝对路径的src和dest，示例任务：

  - name: 创建Nginx站点符号链接
    file:
      src: /etc/nginx/sites-available/foobar.conf
      dest: /etc/nginx/sites-enabled/foobar.conf
      state: link
  

• 别忘了在创建链接后重启Nginx，让新配置生效：

  - name: 重启Nginx服务
    service:
      name: nginx
      state: restarted
      enabled: yes
  

5. 确认Vagrant的Provision顺序

如果是Vagrant启动时自动执行Ansible provision，要确保任务顺序正确：先安装Nginx，再生成配置文件，接着创建符号链接，最后重启服务。顺序错了的话，可能会出现链接先创建但Nginx还没安装的情况。

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