KSWEB Web 服务器启动失败 看状态页红提示和日志文件

现象

打开 Lighttpd / Apache / Nginx 开关，回到状态页看状态——显示 "服务器未启动" 或 红色警告，手机浏览器访问 localhost:8080 打不开。

排查步骤

第一步：看状态页红提示

状态页里哪个服务器出问题，它的状态旁边会有红色高亮的错误提示，点一下能看到简短摘要。KSWEB 能捕获到的错误会直接显示在这里，比如端口被占用、配置文件语法错误。

如果红提示里写的是"配置文件语法错误"，跳到第三步看日志。

第二步：看服务器自己的日志文件

每个 Web 服务器标签页里都有 Log File / Log 按钮，点一下直接打开完整日志。服务器启动失败时，日志最后几行就是原因：

端口被占用

2026/10/14 10:00:00 (server.c.2222) server socket bind failed: Address already in use

解决：另一个进程已经占了这个端口。要么停掉那个进程，要么在 KSWEB 里给服务器换个端口（>1024 不用 root）。

配置文件语法错误（Apache）

Syntax error on line 45 of /data/data/.../httpd.conf:
Invalid command 'Restart', perhaps misspelled or defined by a module not included in the server configuration

解决：在服务器标签页里 Edit Configuration，找到第 45 行附近，把拼错的指令改成正确的。或者先备份配置再恢复默认配置（KSWEB 设置里有"恢复默认配置"按钮）。

配置文件语法错误（Lighttpd）

2026-10-14 10:00:00: (configfile.c.953) Warning: 'server.modules' includes unknown-modkey 'mod_rewrte'

这里的 mod_rewrte 是拼错了（正确是 mod_rewrite）。Edit Configuration 改过来保存即可。

PHP 版本缺失

PHP not found at /data/data/ru.kslabs.ksweb/files/php/bin/php

解决：KSWEB 组件安装不完整。SETTINGS → Components → 重新下载 PHP 组件。

第三步：停一个启一个试

三个服务器可以同时开，但某些错误是互相影响的。如果 Lighttpd 和 Apache 同时启动失败：

1. 只开 Lighttpd（关 Apache 和 Nginx）→ 重启服务器
2. 看 Lighttpd 能不能起来
3. 不行再只开 Apache 试
4. 确认是哪一个服务器有问题再针对性修

第四步：重启手机

听起来像偷懒但很有效——Android 的进程管理偶发会卡住。重启手机后直接开 KSWEB，看看组件能不能自动起来。

第五步：KSWEB SETTINGS 里的其他工具

• 测试端口可用性 — TOOLS 里有端口测试工具，输入端口号看是否被占用
• 恢复默认配置 — 如果自己改了配置搞砸了，恢复默认配置能一键重置服务器配置文件（不会删 htdocs 里的网站文件）
• MySQL 日志 — MySQL 启动失败同理，MySQL 标签页里也有日志按钮，常见原因是 3306 端口被 MariaDB 同时占用或数据文件损坏

常见错误原因汇总