必须先部署并持续运行codex render后端服务，确认系统为ubuntu 20.04+/debian 10+/centos 7+、node.js≥22.0.0且npm≥10.0.0，安装lts版node.js，全局安装@codex/render-server，初始化配置并设端口8081，通过systemd守护进程启用开机自启，最后用curl验证/health接口返回status:ok。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Linux服务器上让Codex Render插件真正跑起来，必须先部署配套后端服务并确保其持续可用，否则插件调用时会直接返回503或超时错误。
确认系统与运行环境
执行cat /etc/os-release | grep -E "(NAME|VERSION)"确认发行版为Ubuntu 20.04+、Debian 10+或CentOS 7+；运行node -v && npm -v检查Node.js ≥22.0.0且npm ≥10.0.0。若任一不满足，后续所有步骤将失败。
Ubuntu/Debian用户执行：curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs；CentOS/RHEL用户执行：sudo yum install -y nodejs npm；Arch Linux用户执行：sudo pacman -S nodejs npm。
【Node.js必须使用LTS版本，非LTS版本会导致Codex Render服务启动后立即崩溃】
安装并启动Codex Render后端服务
全局安装Render服务：执行sudo npm install -g @codex/render-server。
创建服务目录并初始化配置：mkdir -p ~/codex-render && cd ~/codex-render && render-server init。该命令会生成config.json和plugins/子目录。
编辑配置文件：nano config.json，将"port"设为8081，"cors_origin"设为"*"（开发调试用），"log_level"设为"info"。保存退出。
启动服务：render-server start。终端应输出Server running on http://localhost:8081且无ERROR字样。
配置systemd守护进程
创建服务单元文件：sudo nano /etc/systemd/system/codex-render.service，填入以下内容：
PyCharm 2026.2.0.1 Linux版提供 JetBrains 官方 2026.2.0.1 版本安装包，适合需要指定 PyCharm 版本进行 Python 项目开发、运行和调试的用户。
[Unit]<br>Description=Codex Render Backend<br>After=network.target<br><br>[Service]<br>Type=simple<br>User=$USER<br>WorkingDirectory=/home/$USER/codex-render<br>ExecStart=/usr/bin/npx render-server start<br>Restart=always<br>RestartSec=10<br>StandardOutput=journal<br>StandardError=journal<br><br>[Install]<br>WantedBy=multi-user.target
重载systemd配置：sudo systemctl daemon-reload。
启用开机自启：sudo systemctl enable codex-render.service。
立即启动服务：sudo systemctl start codex-render.service。
验证状态：sudo systemctl status codex-render.service，看到active (running)且Loaded: loaded即成功。
部署监控脚本实时盯梢
方法一：基础日志轮询监控
新建脚本~/monitor-render.sh，内容为：
#!/bin/bash<br>if ! curl -s --head --fail http://localhost:8081/health | grep "200 OK" > /dev/null; then<br> echo "$(date): Render service DOWN" >> /var/log/codex-render-alert.log<br> sudo systemctl restart codex-render.service<br>fi。
赋予执行权限：
chmod +x ~/monitor-render.sh。方法二：集成XRK File Monitor精准告警
下载XRK监控源码包，解压后编辑xrk_monitor_info_list.conf，添加一行：/home/$USER/codex-render/config.json（监控配置变更）；
编辑xrk_linux_file_monitor.conf，设置XRK_MONITOR_METHOD=fmd5、XRK_WARN_OPR_INFO=mod、XRK_WARN_METHO=lock；
执行./xrkmonitor_file_monitor.sh init初始化快照；
最后运行./add_crontab.sh使每分钟扫描一次。
【XRK_WARN_METHO=lock模式下，任何config.json被意外修改都会触发锁定并写入告警日志，防止配置漂移】
手动触发一次健康检查：curl http://localhost:8081/health，返回{"status":"ok","timestamp":...}即表示后端已就绪，Codex Render插件可安全连接。
