如何从命令行开启Kodi web服务器？root运行时配置失效求解

我之前也碰到过一模一样的坑——以root身份跑Kodi时，每次启动都会重置Web服务器设置，advancedsettings.xml还死活不生效，折腾了好一阵才搞定，下面是亲测有效的解决步骤：

1. 先彻底关停Kodi进程 #

修改配置前必须确保Kodi没有后台运行，不然你改的配置会被正在运行的Kodi直接覆盖：

# 杀死所有Kodi进程
killall kodi
# 如果是用systemd服务托管的，先停掉服务
systemctl stop kodi

2. 用advancedsettings.xml强制锁定Web配置 #

advancedsettings.xml的优先级比guisettings.xml高，只要格式正确，Kodi会优先读取这里的规则，不会再随便覆盖Web服务器设置。你需要在指定的用户数据目录下创建（或修改）这个文件，内容要严格遵循XML格式：

<advancedsettings>
  <services>
    <!-- 强制开启Web服务器 -->
    <webserver>true</webserver>
    <!-- 自定义Web端口，默认是8080，可按需修改 -->
    <webserverport>8080</webserverport>
    <!-- 可选：设置Web访问的账号密码，提升安全性 -->
    <webserverusername>kodi_admin</webserverusername>
    <webserverpassword>your_secure_pass</webserverpassword>
    <!-- Web界面皮肤保持默认即可 -->
    <webskin>default</webskin>
  </services>
</advancedsettings>

创建完后一定要验证XML语法是否正确，格式错误是导致配置无效的常见原因：

xmllint /path/to/your/custom/userdata/advancedsettings.xml

如果没有报错输出，说明格式没问题。

3. 启动时明确指定用户数据目录 #

很多时候配置被覆盖，是因为Kodi没用到你指定的用户文件夹。启动Kodi时必须加上--userdata参数强制指定路径：

# 替换成你自己的用户数据目录路径
kodi --userdata /path/to/your/custom/kodi/userdata

如果是用systemd自动启动Kodi，得修改服务配置文件（通常在/etc/systemd/system/kodi.service），在ExecStart行加上参数：

[Service]
User=root
Group=root
# 这里加上--userdata指定你的自定义目录
ExecStart=/usr/bin/kodi --userdata /path/to/your/custom/kodi/userdata
Restart=on-failure

修改后重新加载systemd并重启服务：

systemctl daemon-reload
systemctl restart kodi

4. 确保用户目录权限正确 #

指定的用户文件夹必须属于root用户，否则Kodi无法读写配置文件：

# 递归设置目录所有者为root
chown -R root:root /path/to/your/custom/kodi/userdata
# 设置安全权限，700仅允许root访问，避免其他用户篡改
chmod -R 700 /path/to/your/custom/kodi/userdata

5. 验证配置是否生效 #

启动Kodi后，用下面的命令检查Web服务器是否正常监听端口：

# 替换成你设置的端口号
netstat -tulpn | grep 8080

如果能看到Kodi进程在监听对应端口，说明配置已经生效了。

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