如何修正Nginx unit文件中的无效转义序列并正确挂载Docker卷

错误原因分析 #

你遇到的问题核心是systemd对ExecStart指令的续行格式有严格要求：当你用\来换行续写命令时，\后面不能有任何字符（包括空格、制表符），必须直接跟换行。你的unit文件里大概率是在反斜杠后不小心加了空格，导致systemd识别成无效的转义序列，从而抛出错误。

另外还要注意：你同时挂载了/etc/ssl和它的子目录/etc/ssl/certs、/etc/ssl/private，这会导致子目录的挂载覆盖父目录里的对应路径内容，可能达不到你预期的挂载效果，建议根据实际需求调整。

修正后的nginx.service文件 #

下面是调整后的unit文件，确保续行反斜杠后无空格，并且优化了挂载逻辑（如果确实需要同时挂载父目录和子目录可保留，否则建议删除重复挂载）：

[Service]
Restart=always
ExecStartPre=-/usr/bin/docker kill %p
ExecStartPre=-/usr/bin/docker rm -f %p
ExecStart=/usr/bin/docker run -t --rm --name %p \
-p 80:80 -p 443:443 \
--link custodian:custodian --volumes-from custodian \
-v /etc/ssl:/etc/ssl \
-v /var/www/letsencrypt/.well-known/acme-challenge:/var/www/letsencrypt/.well-known/acme-challenge \
%p
ExecStop=/usr/bin/docker stop %p

额外说明 #

• 如果你其实只需要挂载/etc/ssl/certs和/etc/ssl/private，而不是整个/etc/ssl，可以把-v /etc/ssl:/etc/ssl替换成那两个子目录的挂载，避免冲突：

  -v /etc/ssl/certs:/etc/ssl/certs \
  -v /etc/ssl/private:/etc/ssl/private \
  

• 修改完unit文件后，需要重新加载systemd配置并重启nginx服务：

  sudo systemctl daemon-reload
  sudo systemctl restart nginx.service
  

• 可以用下面的命令检查unit文件是否有语法错误，提前排查问题：

  sudo systemd-analyze verify nginx.service
  

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