lighttpd启动失败（状态码255）及配置文件字符异常求助

问题现象 #

启动lighttpd服务时持续报错，Pihole网页也无法正常加载：

• 执行systemctl start lighttpd提示：

Job for lighttpd.service failed because the control process exited with error code.

• 执行systemctl status lighttpd.service显示：

lighttpd.service - Lighttpd Daemon
     Loaded: loaded (/lib/systemd/system/lighttpd.service; enabled; vendor preset: enabled)
    Drop-In: /etc/systemd/system/lighttpd.service.d
             └─dietpi.conf
     Active: failed (Result: exit-code) since Sun 2023-04-23 22:27:55 BST; 9s ago
    Process: 209906 ExecStartPre=/usr/sbin/lighttpd -tt -f /etc/lighttpd/lighttpd.conf (code=exited, status=255/EXCEPTION)
        CPU: 10ms

Apr 23 22:27:55 iphone systemd[1]: lighttpd.service: Scheduled restart job, restart counter is at 5.
Apr 23 22:27:55 iphone systemd[1]: Stopped Lighttpd Daemon.
Apr 23 22:27:55 iphone systemd[1]: lighttpd.service: Start request repeated too quickly.
Apr 23 22:27:55 iphone systemd[1]: lighttpd.service: Failed with result 'exit-code'.
Apr 23 22:27:55 iphone systemd[1]: Failed to start Lighttpd Daemon.

• 执行lighttpd -t -f /etc/lighttpd/lighttpd.conf检查配置时提示：

2023-04-23 21:47:27: configfile.c.1909) source: /etc/lighttpd/lighttpd.conf line: 2 pos: 1 invalid character in variable name
2023-04-23 21:47:27: configfile.c.1967) configfile parser failed at: (

已尝试操作 #

• 重装lighttpd
• 清理apache残留文件
• 更新系统
• 安装Gamin

解决步骤 #

1. 修复配置文件语法错误 #

核心问题是/etc/lighttpd/lighttpd.conf第2行存在非法字符，导致配置解析失败：

• 打开配置文件：nano /etc/lighttpd/lighttpd.conf
• 定位到第2行，检查开头是否有特殊字符（比如括号(、不可见字符、中文符号等）
• 删除或修正非法字符，确保行首为合法的配置变量（例如server.document-root）
• 保存退出后，重新执行lighttpd -t -f /etc/lighttpd/lighttpd.conf验证配置，无报错则继续

2. 恢复默认配置（手动修复困难时） #

如果不确定配置问题点，可直接恢复默认配置：

• 备份当前配置：cp /etc/lighttpd/lighttpd.conf /etc/lighttpd/lighttpd.conf.bak
• 提取软件包默认配置（适用于Debian/Ubuntu/DietPi系统）：

  dpkg -S lighttpd.conf | awk '{print $2}' | xargs zcat > /etc/lighttpd/lighttpd.conf
  

• 再次验证配置：lighttpd -t -f /etc/lighttpd/lighttpd.conf

3. 重启服务并验证 #

配置验证通过后，启动服务：

systemctl start lighttpd

检查运行状态：

systemctl status lighttpd

4. 恢复Pihole配置（若需） #

如果Pihole依赖lighttpd，执行修复命令恢复其web服务配置：

pihole -r

选择「修复」选项，自动完成Pihole相关配置的恢复。

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