DOCUMENTATION CENTER

Project Xiomn 文档中心。

服务器、Zeabur、域名、code-server、3X-UI、节点、Bot、备份、迁移和排错都从这里进入。

CURRENT ARCHITECTURE

当前结构

先区分网页、程序接口、管理面板和节点域名,再进行排错。

当前结构:

Project-Xiomn-Website
├─ xiomn.com
├─ /services
├─ /docs
├─ /status
└─ /system(密码保护)

独立服务
├─ code.xiomn.com       code-server / Coder
├─ panel.xiomn.com:2053 3X-UI
├─ node.xiomn.com       Xray / Reality 节点
└─ bot.xiomn.com        Telegram AI Bot

STEP-BY-STEP GUIDES

新手详细教程

每一步都有命令示例、检查清单、常见错误、安全提醒和回滚建议。

IMPORTANT

最重要的入口

ROUTES

域名与用途

xiomn.comProject-Xiomn-Website个人主页 + 文档 + /system
code.xiomn.comcode-server / Coder浏览器开发环境
panel.xiomn.com:20533X-UI节点管理面板
node.xiomn.comXray / Reality节点域名,不是网页
bot.xiomn.comTelegram-AI-Bot-ProBot 后端;/status 给人查看

DEPLOYMENT

部署与排错

服务器部署记录

早期 Nginx、HTTPS、Astro、GitHub、deploy.sh 的部署记录。

打开 →

Zeabur 部署排错

BackOff、端口、环境变量、pdf-parse、启动失败排查。

打开 →

Telegram Bot Zeabur 部署

Telegram-AI-Bot-Pro 在 Zeabur 的部署顺序、变量和排错点。

打开 →

BOT DEVELOPMENT

Telegram AI Bot 开发

Telegram AI Bot

Bot 功能、环境变量、已知错误、下一步计划。

打开 →

Gemini 与 Gemini Live

普通 Gemini、Gemini Live、语音、Provider 架构设计。

打开 →

Copilot 重构提示词

可直接给 GitHub Copilot Agent 的完整重构要求。

打开 →

BACKUP

备份与迁移

环境变量备份

记录变量名、用途和模板,真实 Key 不进 GitHub。

打开 →

数据卷备份

记录 Volume、SQLite、上传文件、code-server 工作目录备份规则。

打开 →

COMMANDS

常用检查命令

检查 K3s

sudo systemctl status k3s --no-pager

看全部 Pod

sudo k3s kubectl get pods -A

看异常 Pod

sudo k3s kubectl get pods -A | grep -v Running

检查 3X-UI

sudo x-ui status

检查节点 DNS

getent hosts node.xiomn.com

UPDATE FLOW

官网更新流程

以后官网更新流程:

npm run build
node --test
git add .
git commit -m "update website"
git push

然后等待 Zeabur 自动重新部署。

RULES

必须遵守的规则

01

同一个域名只绑定一个服务,xiomn.com 不再同时绑定旧 Portal。

02

官网更新走 GitHub → Zeabur,不再走 /var/www/html。

03

真实 API Key、密码、Bot Token 和节点密钥不提交 GitHub。

04

有数据库、文件、用户设置的服务必须配置 Volume。

05

node.xiomn.com 是客户端节点地址,不用浏览器网页是否打开来判断。

06

bot.xiomn.com/app 是 Telegram Mini App,必须从 Telegram 内打开。