INFRASTRUCTURE

当前服务运行结构。

这页记录每个服务属于哪里。以后看到某个域名时，可以先确认它是网页、管理面板、节点地址还是程序接口。

CURRENT

当前状态

个人主页

Project-Xiomn-Website 使用 Astro 构建，通过 GitHub → Zeabur 自动部署，绑定 xiomn.com。

系统中心

xiomn.com/system 由网站 server.js 动态提供，使用环境变量密码和 HttpOnly Cookie 保护。

code-server

code.xiomn.com 是独立的浏览器开发环境服务。

3X-UI

panel.xiomn.com:2053 是独立服务器管理面板，并由 3X-UI 自己的账号密码二次保护。

Xray 节点

node.xiomn.com 是代理客户端节点域名，不是普通网页。

Telegram Bot

bot.xiomn.com 是 Telegram-AI-Bot-Pro 独立 Zeabur 服务。

DOMAINS

域名绑定关系

xiomn.com

Project-Xiomn-Website

公开主页 + /system

code.xiomn.com

code-server / Coder

开发环境

panel.xiomn.com:2053

3X-UI

管理面板

node.xiomn.com

Xray / Reality

节点连接域名

bot.xiomn.com

Telegram-AI-Bot-Pro

Bot 后端与状态页

COMMANDS

常用检查命令

查看 K3s 状态

sudo systemctl status k3s --no-pager

查看 Zeabur 组件

sudo k3s kubectl get pods -A

查看异常 Pod

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

查看 3X-UI 状态

sudo x-ui status

查看监听端口

sudo ss -lntp

检查节点 DNS

getent hosts node.xiomn.com

PORTS

端口关系

各服务端口不是同一个概念：

Zeabur 网站服务
└─ 读取 process.env.PORT（当前模板默认 3000）

Telegram Bot 服务
└─ 读取自己的 PORT（常用 8080）

3X-UI 管理面板
└─ https://panel.xiomn.com:2053

Xray / Reality 节点
└─ 使用 3X-UI 入站中配置的节点端口

DEPLOY

官网更新流程

以后官网更新流程：

1. 修改 Project-Xiomn-Website
2. npm run build
3. node --test
4. git add .
5. git commit -m "update website"
6. git push

Zeabur 检测到 GitHub 更新后重新构建并部署。

RULES

必须遵守的规则

01

不要把 xiomn.com 同时绑定到旧 Portal 和个人主页服务。

02

网站更新走 GitHub → Zeabur，不再手动复制到 /var/www/html。

03

Zeabur 服务端口必须读取 process.env.PORT。

04

有数据库、上传文件或用户设置的服务必须挂载 Volume。

05

真实 API Key、密码和节点密钥只放环境变量或受保护配置，不提交 GitHub。

06

node.xiomn.com 浏览器打不开时，先查 DNS、端口和客户端连接，不要把它当普通网站排查。