树莓派Zero W中c-lightning手动启动正常，systemd启动失败求解

我之前在Raspberry Pi Zero W上折腾过pruned模式的c-lightning开机自启，碰到过和你一模一样的问题——手动启动正常，systemd启动就卡成inactive (dead)。折腾了好几天终于搞定，分享下我的配置和踩过的坑：

可行的lightning.service配置 #

[Unit]
Description=c-lightning Lightning Network Daemon
After=bitcoin.service network.target
Requires=bitcoin.service
Wants=network.target

[Service]
ExecStart=/usr/local/bin/lightningd --conf=/home/doge/.lightning/config --datadir=/home/doge/.lightning
User=doge
Group=doge
Type=simple
Restart=on-failure
RestartSec=60
TimeoutStartSec=600  # Pi Zero W性能弱，给足启动时间
RuntimeDirectory=lightningd
RuntimeDirectoryMode=0700
PrivateTmp=true
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true

[Install]
WantedBy=multi-user.target

关键调整点说明 #

• 新增network.target依赖：c-lightning需要网络连接才能和Bitcoin节点通信，确保启动时网络已经就绪
• 明确指定配置和数据目录：手动启动时，lightningd默认读取当前用户home下的.lightning目录，但systemd启动时的环境变量可能不同，必须通过--conf和--datadir强制指定路径，避免找不到配置文件
• 延长启动超时：Pi Zero W的CPU性能有限，pruned模式的c-lightning启动需要更长时间，把TimeoutStartSec从300秒调到600秒足够应对
• 安全增强参数：加入ProtectSystem、PrivateTmp等参数，既提升安全性也避免一些权限冲突

可能导致启动失败的其他原因 #

1. 目录权限问题：检查/home/doge/.lightning的权限，确保doge用户拥有完整的读写权限：

   sudo chown -R doge:doge /home/doge/.lightning
   sudo chmod -R 700 /home/doge/.lightning
   

2. Bitcoin节点未完全就绪：确认bitcoin.service已经启动并完成同步（pruned模式下也需要同步到最新区块），可以用systemctl status bitcoin查看状态
3. 日志排查：这是最有效的排障方法，执行以下命令查看实时启动日志，里面会显示具体的错误信息（比如连接Bitcoin节点失败、配置错误等）：

   journalctl -u lightning.service -f
   

4. c-lightning编译问题：如果是自己编译的c-lightning，确保在Pi Zero W上编译时没有依赖缺失，手动启动能正常运行的话这条可能性较低，但可以重新检查编译参数

我当初就是因为没指定数据目录和启动超时时间太短导致的失败，调整后服务就能正常开机自启了。

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