把服务器用明白
从看懂一台远程电脑,到自己检查运行状态。用你的官网、农业知识库和微信运营助手,把域名、SSH、部署与维护串起来。
12 课 · 可离线阅读 · 命令标注执行环境 · 配置核对:2026-10-05先看懂:你的项目怎样运行
先知道每个部件干什么,再学按钮和命令。
服务器是一台租用的远程电脑。腾讯云提供计算、磁盘和网络;你负责安装应用、管理资料、更新代码和维护运行环境。轻量应用服务器采用较简化的套餐与控制台,适合你目前的网站和应用部署。
编辑代码、打开浏览器、通过 SSH 管理服务器。你电脑上的 Docker 可以关闭。
持续运行官网、农业知识库、微信运营助手,并保存它们的数据。
接收应用发出的模型请求,完成问答、写作或嵌入计算,按相应规则计费。
点一个入口,看看请求去哪里
Nginx 直接返回 HTML、图片、CSS 和 JavaScript,无需 Python 后台。
DNS 先帮助浏览器找到 IP;建立 HTTPS 连接时浏览器发送域名信息,Nginx 选择相应证书和站点,再返回网页或转发到后台。三个域名可以共用一个 IP,同时显示不同内容。
| 名词 | 它负责什么 | 在你这里是什么 |
|---|---|---|
| 域名 / DNS | 用容易记的名字找到服务器 | 三个入口都指向同一个公网 IP |
| 端口 | 区分网络服务的入口 | 22 管理、80 HTTP、443 HTTPS |
| Nginx | 提供官网文件、转发应用请求 | 三个域名的统一入口 |
| systemd | 启动服务、管理进程和开机运行 | 让后台不依赖你开着终端窗口 |
| PostgreSQL / SQLite | 保存结构化业务记录 | 知识库与运营助手使用的数据库 |
| Qdrant 向量库 | 找出与问题含义相近的资料片段 | 农业知识库的检索组件 |
你的服务器:配置与项目位置
这部分是本次部署的实际记录,不是通用示例。
配置来自你的控制台截图和部署检查。截图中的流量包为 2500 GB/月;剩余流量、计费和到期状态以控制台当前显示为准。你人在海口,不会改变这台服务器所在的北京地域;创建和绑定腾讯云 SSH 密钥时,要选服务器所在地域。
| 项目 | 浏览器地址 | 服务器代码位置 |
|---|---|---|
| 公司官网 | xunshanshengwu.cn ↗ | /srv/xunshan/current/website |
| 农业知识库 | kb.xunshanshengwu.cn ↗ | /srv/xunshan/current/knowledge/xunshan-rag-platform |
| 微信运营助手 | wechat.xunshanshengwu.cn ↗ | /srv/xunshan/current/wechat |
哪些内容已经部署
- 三套项目均已部署,域名和 HTTPS 已配置。
www官网跳转到主域名,HTTP 跳转到 HTTPS。 - 服务器上使用原生 Python 虚拟环境、原生 PostgreSQL、Qdrant 和 Nginx;本次没有安装服务器 Docker。
- 农业向量集合
xunshan_agri_chunks_v2_20260829通过快照迁移,迁移时核对为 15,454 条记录、4096 维、Cosine 距离。迁移没有重新生成向量。 - 本次部署采用版本目录
/srv/xunshan/releases/20261004-2215,current是指向当前版本的软链接。 - 证书
xunshan-internal覆盖官网、www、kb、wechat,当前记录的到期日为 2027-01-02;已启用自动续期并完成模拟验证。
下一步还可以补充什么
- 项目定时数据备份:尚未配置。已存在初始迁移备份与配置修改前的手工备份。
- 运行告警:还没有为这三个项目建立专门的业务告警。
- CDN:当前这些域名直接访问服务器,未接入 CDN;账号以前是否开通过其他 CDN 服务,未在本次检查中确认。
- 云控制台备份设置:本机部署记录不能证明控制台是否开启系统盘自动备份,要到腾讯云控制台查看。
控制台上的按钮:什么时候用
腾讯云控制台管理云资源;项目的日常使用从应用域名进入。
进入 腾讯云控制台 → 轻量应用服务器 → 服务器 → Ubuntu-FMjs。界面可能随版本调整,可按这些功能名称寻找对应入口。
| 入口 / 按钮 | 用途与操作 | 对项目的影响 |
|---|---|---|
| 概要 | 查看 IP、运行状态、套餐和到期日 | 查看不影响运行 |
| 监控 | 查看 CPU、内存、磁盘、带宽与流量曲线 | 查看不影响运行 |
| 登录 / OrcaTerm | 打开云端终端,执行 Linux 命令 | 打开终端不等于重启服务器 |
| 防火墙 | 添加或编辑允许进入的端口和来源 | 规则立即影响访问;无需为此重启 |
| SSH 密钥 | 管理连接服务器用的密钥与实例绑定 | 绑定方式可能触发关机、开机,应先看提示 |
| 重置密码 | 修改操作系统账户密码 | 改变服务器密码登录凭据;具体生效过程看确认页 |
| 文件管理 | 上传、下载、编辑服务器文件 | 改运行中的代码和资料前先备份 |
| 重启 | 整个系统重新启动 | 所有项目短暂中断;要检查服务是否恢复 |
| 关机 / 开机 | 停止 / 启动服务器系统 | 关机后网站和应用停止响应;计费以套餐规则为准 |
| 快照 / 云硬盘备份 | 保存磁盘某个时刻的状态 | 回滚整盘会影响代码、配置和业务数据 |
| 续费 / 升级套餐 | 保持资源有效、调整配置 | 涉及费用;升级过程是否中断看操作页说明 |
| 重装系统 / 销毁实例 | 重新初始化系统 / 移除云资源 | 属于高影响操作,先核对实例、导出数据与恢复方法 |
做一次控制台巡检
- 核对实例名、IP 与北京地域,确认正在查看正确的机器。
- 看运行状态和到期日,再看本月流量与近期带宽峰值。
- 查看监控趋势:CPU 持续升高、内存不足或磁盘接近满时,先找具体服务和日志。
- 进入快照 / 云硬盘页面,核对最近备份时间、保留期限和当前配额。
- 完成检查后直接离开控制台,项目会继续由服务器运行。
每次扫码登录麻烦,怎么减少?
电脑微信已登录并绑定同一腾讯云账号时,可以尝试微信快捷登录。也可以在账号中心的安全设置中创建通行密钥,用设备 PIN、指纹等完成验证,额外登录保护仍可能要求二次验证。
登录状态管理可调整最大保持时间(最多 72 小时)与无操作保持时间(最多 48 小时),修改后下一次登录生效。关闭浏览器就掉登录时,检查是否用了无痕窗口或自动清理 Cookie。
参考:腾讯云登录方式 ↗参考:创建通行密钥 ↗参考:设置登录保持时间 ↗SSH:从你的电脑管理服务器
先分清“在 Windows 输入”与“登录后在 Linux 输入”。
SSH 是加密的远程管理连接。你使用本机私钥证明身份,服务器核对对应公钥;登录后,输入的命令就在远程 Ubuntu 上执行。HTTPS 是网页连接,SSH 是管理连接,二者各自运行。
第一步:在 Windows PowerShell 连接
ssh -i "C:\xunshanshengwu.pem" ubuntu@192.144.189.143-i 后面是本机私钥文件路径;ubuntu 是远程用户名;@ 后面是服务器 IP。这里默认使用 22 端口。命令里的引号是 PowerShell 的路径语法;在应用的“身份文件路径”输入框通常填写纯路径即可。
第二步:确认你已进入远程机器
whoami
pwd
hostnamewhoami 应显示 ubuntu;pwd 显示远程当前目录;hostname 显示服务器主机名。终端通常出现 ubuntu@…:~$,接下来用的是 Linux 命令。
第三步:查看项目目录
ls -lah /srv/xunshan/current/
readlink -f /srv/xunshan/currentls 查看文件列表;readlink -f 查看 current 实际指向哪个版本。sudo 表示以管理员权限执行某条命令,权限越高,操作前越要确认路径与影响。
第四步:退出连接
exit退出 SSH 会话不会停止由 systemd 管理的项目。实时查看日志时按 Ctrl + C 结束“跟随日志”,也不会关闭应用。
上传与下载:SCP
下面是示例,需要把本地包路径和远程文件名换成实际文件。先传到暂存位置,再按部署流程发布,避免上传旧数据覆盖同事刚写入的记录。
scp -i "C:\xunshanshengwu.pem" "E:\你的项目\release.tar.gz" ubuntu@192.144.189.143:/tmp/release.tar.gz下载时调换来源和目标。例如下载管理员已生成的备份文件:
scp -i "C:\xunshanshengwu.pem" ubuntu@192.144.189.143:/srv/xunshan/backups/请替换为备份文件 "C:\Users\LENOVO\Downloads\"为什么 SSH 通了,Codex 远程入口还说“需要登录”?
SSH 连接验证的是操作系统访问权限;Codex 远程任务还需要服务器上的 Codex CLI 登录模型账号。服务器已有 CLI,但此前账号登录返回地区不支持的 403。普通 SSH 管理仍可使用。
你电脑上的代理不会自动改变服务器的网络出口;服务器自身访问模型服务的能力,需要单独核对。安装图形桌面也不会自动解决账号登录问题。
域名、防火墙、HTTPS:三个独立步骤
把“能找到服务器”“能连进去”“网页加密”分别配置。
域名解析:添加 A 记录
进入 腾讯云云解析 DNS / DNSPod → 权威解析 → xunshanshengwu.cn → 记录管理 → 添加记录。轻量云的域名页面也能引导添加解析。下面是你现有域名对应的设置:
| 主机记录 | 记录类型 | 线路 | 记录值 | 结果 |
|---|---|---|---|---|
| @ | A | 默认 | 192.144.189.143 | 主域名官网 |
| www | A | 默认 | 192.144.189.143 | www 官网入口 |
| kb | A | 默认 | 192.144.189.143 | 知识库子域名 |
| A | 默认 | 192.144.189.143 | 运营助手子域名 |
@ 代表域名本身,kb 代表子域名前缀。A 记录对应 IPv4;AAAA 对应 IPv6;CNAME 对应另一个域名。修改后可能暂时受到 DNS 缓存影响,先查解析结果。没有部署 IPv6 服务时,先不要额外添加 AAAA。
Resolve-DnsName kb.xunshanshengwu.cn -Type A防火墙:让指定入口可以进入
进入实例的防火墙 → 添加规则,填写协议、端口、来源和允许策略。已有正确规则时不用重复添加。
| 端口 / 协议 | 用途 | 在当前架构中的处理 |
|---|---|---|
| 22 / TCP | SSH 管理 | 供管理员连接;缩小来源前先确认自己的出口 IP 和备用登录方式 |
| 80 / TCP | HTTP 跳转、证书校验 | 保留公网可达,供当前 HTTP-01 证书验证使用 |
| 443 / TCP | HTTPS 网页 | 对访问网站和应用的用户开放 |
| 8000、8010 | 两个 Python 后台 | 绑定 127.0.0.1,由 Nginx 转发,无需开放公网 |
| 5432、6333、6334 | PostgreSQL、Qdrant | 保持仅服务器本机可访问;应用通过本机连接 |
0.0.0.0/0 表示所有 IPv4 来源,不表示仅公司访问。云防火墙、操作系统防火墙、服务监听地址都会影响访问;打开云端端口也不能让绑定 127.0.0.1 的服务直接从公网访问。
Test-NetConnection 192.144.189.143 -Port 443看输出中的 TcpTestSucceeded。它只证明 TCP 可以连接,不证明域名、证书和业务功能全部正常。
HTTPS:证书与自动续期
- 先让所需域名解析到服务器,并确认 HTTP 80 端口可以访问。
- 配置 HTTP 验证路径,让
/.well-known/acme-challenge/可以返回证书验证文件。 - 使用 Certbot 申请包含所需域名的证书,并把证书路径配置到 Nginx。
- 检查配置、加载 HTTPS 443 站点,然后设置 HTTP 跳转。
- 启用定时续期,并验证续期成功后 Nginx 会重新加载新证书。
这套已经配好,日常主要是查看与验证,不需要反复申请新证书:
sudo certbot certificates
systemctl status certbot.timer --no-pagersudo certbot renew --cert-name xunshan-internal --dry-runHTTPS 通过证书和握手保护浏览器到服务器的连接;网页登录密码负责限制访问者。取消密码后,HTTPS 仍可正常加密。
参考:Certbot 续期说明 ↗CDN 放在哪一层?
CDN 可在用户和源服务器之间缓存静态资源。接入时通常由服务商提供 CNAME,再设置回源与 HTTPS。官网的图片、CSS、JS 可按需要加速;知识库的私人响应、问答接口、设置和运营数据应绕过共享缓存。你当前三个域名尚未接入 CDN,先把直接访问和维护流程用熟即可。
参考:CDN 缓存与登录场景 ↗参考:轻量服务器 ICP 备案 ↗部署一个项目:按这个顺序做
部署包括代码、运行环境、配置、数据、常驻服务和对外入口。
把文件传上服务器只是其中一步。以下是以后部署或迁移新项目时可复用的流程;你现有三个项目已经完成部署,无需从头重做。
- 盘点项目需要什么
写清:启动命令、Python / Node 版本、依赖文件、环境变量、数据库、上传资料目录、向量集合、应用端口,以及首页 / 健康检查地址。确认外部模型服务从服务器能够访问。
- 核对目标机器,并先备份
确认实例名和 IP。保存当前代码、Nginx / systemd 配置,并对运行中的数据库和向量集合使用一致性备份方式。记录当前版本,以便出问题时恢复。
- 准备新的版本目录
采用“每次发布一个新目录,再切换 current”的方式。例如
/srv/xunshan/releases/新的发布时间。新版本未验证前,先保持旧版本运行;运行数据最好长期独立存放,不跟着版本目录被替换。 - 上传需要的代码和资源
静态官网通常上传 HTML、CSS、JS、图片,或构建后的 dist / build。Python 应用上传代码与依赖描述。通常排除
.git、本机虚拟环境、node_modules、缓存和临时文件;凭据走单独的受控配置流程。 - 在 Linux 上建立运行环境
创建项目专用虚拟环境,安装已核对版本的依赖;有前端构建时运行相应构建步骤。Windows 的虚拟环境与本机二进制不能直接搬来当 Linux 环境使用。
- 配置账户、权限和环境变量
用专用应用账户运行服务,设置正确目录、工作路径与文件权限。模型 API 密钥、数据库密码留在服务器配置中,前端 HTML / JS 不放这些凭据;也不要打包进公开网页目录。
- 迁移业务数据,再核对
数据库迁移要匹配程序版本与表结构。向量库可以恢复快照;核对集合名、数量、向量维度、距离类型、嵌入模型与索引配置。不要把“上传源码”当成“上传了向量库”。
- 先在服务器本机启动与检查
后台先绑定
127.0.0.1。验证首页、健康接口、数据库和向量检索依赖。执行写入、嵌入或付费模型功能前,应知道会改哪些数据、用多少额度。 - 交给 systemd 常驻运行
服务文件中写清应用账户、工作目录、启动命令和重启策略;启用开机运行。终端里直接启动一个进程,并不自动具备断线后运行与开机启动的保障。
- 配置 Nginx、域名、防火墙和 HTTPS
Nginx 静态站点指向官网目录,应用站点转发到对应后台。先完成 DNS 与 HTTP 校验,再配置 HTTPS;最后按实际使用范围设置访问方式。
- 从使用者电脑完成验收
检查域名解析、证书、跳转、页面与静态资源;验证一次真实业务路径,区分“网页能打开”和“模型功能可用”。会产生费用或写入的数据测试,要控制范围并记录结果。
- 记录版本、验证结果和恢复方法
保存部署说明、代码版本、数据库迁移记录、备份位置和回滚路径。切换后观察服务日志,确认旧数据没有被覆盖、定时任务没有重复启动。
先做低成本健康检查
curl -fsS http://127.0.0.1:8010/api/ready
curl -fsS http://127.0.0.1:8000/health这是服务端检查,不发送文章、不生成新向量。知识库的 ready 用来确认依赖已准备;健康状态通过之后,还要区分模型供应商连通性、真实问答质量和业务权限。
systemd 服务文件长什么样?
下面是教学模板,解释各字段用途。路径、模块名、端口需替换;不要覆盖现有服务文件。Restart=on-failure 管理异常退出后的重启,开机自动启动还需要 enable。
[Unit]
Description=Example Python application
After=network-online.target
Wants=network-online.target
[Service]
User=xunshan
WorkingDirectory=/srv/example/current
EnvironmentFile=/etc/example/app.env
ExecStart=/srv/example/venv/bin/python -m uvicorn app.main:app --host 127.0.0.1 --port 8020
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.targetNginx 是怎样根据域名转发的?
示意配置中的 server_name 匹配知识库域名,proxy_pass 指向本机知识库进程。完整配置还包含 TLS、转发头、超时、上传大小、缓存和 HTTP 验证路径。
server {
listen 443 ssl;
server_name kb.xunshanshengwu.cn;
# 此处还要配置证书等内容
location / {
proxy_pass http://127.0.0.1:8010;
}
}以后修改项目:备份、发布、验证、回滚
小修改也要知道改的是代码、配置,还是运行中的数据。
| 修改对象 | 通常要做什么 | 怎样确认生效 |
|---|---|---|
| 官网文字 / 图片 | 更新相应静态资源;有构建流程时先构建 | 打开对应页面,检查图片、链接与缓存 |
| 知识库 / 助手代码 | 发布新版本,必要时更新依赖,再重启对应应用 | 健康接口、日志、被修改的功能 |
| 模型 / 数据库配置 | 更新服务端配置,重启读取这些配置的应用 | 确认相应连接与功能;凭据不写进日志 |
| Nginx 域名 / 转发配置 | 备份配置、检查语法、reload | 公网域名与后台访问分别检查 |
| systemd 服务文件 | 修改后 daemon-reload,再重启对应服务 | 服务状态、启动日志与开机启用状态 |
| 数据库结构 / 向量索引 | 单独设计迁移、备份、兼容与恢复方案 | 数量、结构、检索结果和业务功能 |
一次更新的实际步骤
- 明确要改变的页面或功能,并在本机源码保留同一份修改。
- 记录当前版本和相关配置,做受影响数据的备份。
- 在新版本目录准备代码、依赖和配置;有必要时用单独测试端口验证。
- 先检查,再切换版本或替换已备份的小文件;避免覆盖线上新增资料、数据库和输出。
- 只加载 / 重启需要更新的组件,查看日志与健康接口。
- 从浏览器验证目标功能与原有功能;有缓存时刷新正确页面。
- 失败时恢复旧配置 / 旧代码版本,重新验证。保留失败日志以便继续诊断。
重新加载 Nginx
sudo nginx -t && sudo systemctl reload nginxnginx -t 检查配置语法和引用文件。&& 表示前一步成功后才执行下一步。reload 可让 Nginx 加载新配置,正常情况下不需要重启整台机器。
重启单个应用
sudo systemctl restart xunshan-knowledgesystemctl status xunshan-knowledge --no-pager
sudo journalctl -u xunshan-knowledge -n 80 --no-pager若只改微信运营助手,服务名换成 xunshan-wechat。status 的 active 只能说明进程状态,继续用健康接口和目标功能确认更新有效。
如果修改的是 systemd 服务文件
仅修改 .service 或其 drop-in 时需要让 systemd 重新读取配置;改 Python 代码本身通常无需 daemon-reload。
sudo systemctl daemon-reload
sudo systemctl restart xunshan-knowledge在你这台服务器上,常见维护位置
- 官网配置:
/etc/nginx/sites-available/xunshan - 两个应用入口:
/etc/nginx/sites-available/xunshan-internal - 知识库 HTTPS 上传来源设置:
/etc/systemd/system/xunshan-knowledge.service.d/30-https-origin.conf - 代码版本:
/srv/xunshan/releases/;当前指向:/srv/xunshan/current - 手工备份:
/srv/xunshan/backups/
Docker、数据库、向量库:分清关系
Docker 是一种运行与打包方式,应用和数据库也能直接在 Linux 运行。
在 Linux 上直接安装软件。Python 用虚拟环境隔离依赖,systemd 管理服务。你服务器目前使用这种方式。
把程序和运行环境装进镜像,再启动容器。数据库的持久数据需通过卷或挂载保存。
根据项目维护方式选择。换成 Docker 需要重新安排网络、配置和数据挂载,不只是点击一个开关。
Docker 里常见的四个词
| 词 | 含义 | 你要记住的点 |
|---|---|---|
| 镜像 Image | 程序和环境的可复用模板 | 镜像不等于业务数据备份 |
| 容器 Container | 从镜像启动的运行实例 | 能启动、停止、重建 |
| 数据卷 Volume | 独立保存持久文件的位置 | 数据库数据应持久保存;删除卷可能丢数据 |
| Compose 项目 | 把多个相关服务按配置一起管理 | Docker Desktop 中的折叠分组可能是一整套应用 |
数据库和向量库在农业知识库中做什么
普通数据库保存结构化记录,例如资料信息、任务状态和会话记录;向量库保存用于相似性检索的向量与片段关联信息。两者互相配合,也要与原始资料和索引 manifest 对得上。
问答流程通常是:接收问题 → 找相关资料片段 → 组织提示 → 调用模型 → 返回结果与引用。部分流程还会为问题生成查询向量,具体取决于应用实现与配置。
现在可以查看实际监听地址
sudo ss -lntp127.0.0.1:8010 表示只有服务器本机可连知识库后台;0.0.0.0:443 表示 Nginx 在所有 IPv4 网络接口上监听,公网能否进入还取决于防火墙与网络。日志里出现进程名称和端口,不代表已对所有用户开放。
备份与恢复:保存能重新运行的一整套东西
有代码副本,不等于有最新业务数据;有备份,也要确认能恢复。
你的项目已经有初始迁移备份,位置为 /srv/xunshan/backups/20261004-initial/,后续配置操作也保存了手工备份。目前没有项目定时数据备份任务。同一台服务器上的备份能应对部分误操作,但服务器或磁盘出问题时,需要另一处副本。
| 备份对象 | 应包含什么 | 恢复时注意 |
|---|---|---|
| 代码与依赖 | 发布版本、依赖清单、启动方式 | 知道哪个版本与数据结构匹配 |
| 应用配置 | 环境变量、服务文件、Nginx 配置 | 包含密钥的副本仅管理员可读,不放进网站目录 |
| 微信助手 SQLite | 一致性数据库备份、资料和输出文件 | 运行中不能只随手复制主数据库文件,可能还有 WAL 数据 |
| 知识库 PostgreSQL | 数据库导出、所需角色与扩展信息 | 用数据库工具恢复;确认版本、连接配置与权限 |
| 知识库 Qdrant | 集合快照、集合名与嵌入模型信息 | 恢复后核对数量、维度和检索结果 |
| 原始资料与 manifest | 上传资料、索引映射、相关文件元信息 | 与数据库和向量集合对应,避免引用断链 |
应用数据备份:六步流程
- 记录备份范围与时间
写清发布版本、数据库和集合名称。为需要相互对应的数据设置一致的备份窗口,必要时暂停资料导入等写入任务。
- 用对应工具生成数据副本
PostgreSQL 使用
pg_dump等数据库备份工具;SQLite 使用在线备份接口或.backup;Qdrant 使用集合快照。Qdrant 的单个集合快照不等于整套项目备份。 - 保存资料与配置
将原始文件、manifest、依赖清单和启动配置放入同一个有日期的备份目录。密钥与普通代码分开保管。
- 核对副本
确认文件存在、大小合理、生成过程没有报错。保存校验值;数据库导出可核对对象列表,向量快照记录数量和维度。
- 复制到服务器外
下载到受保护的公司电脑或专用备份存储。含客户资料或 API 密钥的备份,应限制访问并加密保存。
- 试恢复后再清理旧备份
在临时目录、临时数据库和新的向量集合中恢复,做一次检索与资料引用检查。验证通过后按保留规则清理过期副本。
云快照 / 系统盘备份:另一层保护
腾讯云磁盘快照保存整块磁盘某个时刻的状态,适合重大升级前留一份恢复点。系统盘自动备份则要在控制台核对是否启用、最近备份时间、保留策略和费用。两者不能替代数据库的一致性备份。
- 控制台打开正确实例的快照 / 云硬盘备份页面,查看可选磁盘、配额、费用与保留期限。
- 重大改动前创建恢复点,并另外导出关键应用数据。
- 需要回滚时,先保存当前新增资料,再核对恢复点时间与磁盘范围。
- 按控制台流程回滚,准备整个实例短暂中断;恢复后检查项目、证书、数据与域名。
建议的维护计划(尚未配置)
可从“每日数据备份 + 重大更新前备份 + 定期服务器外副本 + 每月恢复抽查”开始,再按数据量和可接受的数据损失调整频率与保留天数。Linux 的 systemd timer 或 cron 能按时运行备份脚本;只有任务实际配置并验证成功,才算自动备份已完成。
打不开时:按链路逐层排查
先确定故障在哪一层,避免把所有问题都当成服务器坏了。
从外向内检查:域名解析 → 网络端口 → HTTPS / Nginx → 应用 → 数据库 / 向量库 → 外部模型服务。每一次只改一个有证据的问题,改后重复同一检查。
选一个现象,查看第一步
在本机检查 DNS,预期 kb 解析到 192.144.189.143;未解析时查看记录、DNS 服务与生效情况。
| 现象 | 含义 | 处理方向 |
|---|---|---|
| NXDOMAIN / 找不到域名 | DNS 没返回可用记录 | 检查拼写、DNS 托管位置、A 记录与生效时间 |
| 连接超时 | 连接未在时间内建立 | 检查 IP、实例运行、对应端口、云防火墙与系统防火墙 |
| Connection refused | 连接被拒绝 | 检查目标服务是否监听,端口是否写对;也可能是规则主动拒绝 |
| Host key verification failed | 服务器身份未被信任或已有记录冲突 | 在交互终端查看完整提示并核对指纹;确实换机后才更新对应记录 |
| Permission denied (publickey) | SSH 身份验证失败 | 核对 ubuntu 用户、私钥路径、密钥绑定和文件权限 |
| 证书名称不匹配 / 过期 | 证书与访问域名不符或超出有效期 | 用完整域名访问,检查站点证书、系统时间与续期日志 |
| 401 / 密码框 | 入口要求认证 | 你当前两个应用已取消入口密码;若又出现,核对是否访问旧入口或其他认证层 |
| 403 | 某层拒绝请求 | 查看是 Nginx、应用权限 / Origin 校验,还是模型服务商地区限制;不能只凭数字判断 |
| 502 / 504 | Nginx 无法正常得到后台响应 | 先请求本机健康接口,再看服务状态、应用日志与 Nginx 错误日志 |
| 页面正常,模型调用失败 | 网页入口正常,但模型链路出错 | 看模型请求错误、服务器网络出口、配置、额度与服务商支持范围 |
| 检索无结果 / 引用失效 | 索引、资料或数据关联可能不一致 | 检查集合名称、嵌入维度、manifest 与原始文件;先避免重新导入覆盖 |
| 重启后项目不恢复 | 开机启动或依赖存在问题 | 检查 systemd 是否 enabled,再检查数据库和应用启动日志 |
区分“页面通了”与“功能真的完成”
微信助手的 /health、知识库的 /api/ready 返回正常,证明相应检查通过;它不保证外部模型可用、所有资料能检索或公众号发布成功。功能验收需分别检查真实检索、引用和模型调用。付费模型测试应限制次数与输入规模。
求助时提供这些信息
发出故障时间、完整网址、具体操作、错误文字、最近改动,以及已脱敏的相关日志。不要把私钥文件内容、API 密钥、Cookie 或令牌贴进聊天和截图。
日常维护:看状态、资源、日志和费用
先学会观察运行状态,再安排可控的维护窗口。
| systemd 服务名称 | 负责什么 | 目前的运行入口 |
|---|---|---|
| nginx | 官网、HTTPS 和应用转发 | 公网 80 / 443 |
| xunshan-wechat | 微信运营助手 | 127.0.0.1:8000 |
| xunshan-knowledge | 农业知识库 | 127.0.0.1:8010 |
| xunshan-qdrant | 农业向量检索 | 127.0.0.1:6333 / 6334 |
| postgresql@17-main | 知识库关系数据库 | 127.0.0.1:5432 |
查看服务是否运行、是否开机启动
systemctl is-active nginx xunshan-wechat xunshan-knowledge xunshan-qdrant postgresql@17-main
systemctl is-enabled nginx xunshan-wechat xunshan-knowledge xunshan-qdrant postgresql@17-mainactive 表示当前运行;enabled 表示已设置随系统启动。二者不同:一个服务可以正在运行,但没有配置开机启动。
看最近日志与实时日志
sudo journalctl -u xunshan-knowledge -n 80 --no-pager
sudo tail -n 50 /var/log/nginx/error.logsudo journalctl -u xunshan-knowledge -f看磁盘、内存和负载
df -h
free -h
uptimedf -h 看磁盘容量与占用;free -h 看内存,重点看 available,不要只看 free;uptime 看开机时间与负载。想看实时进程可以输入 top,按 q 退出。
带宽 Mbps 与文件速度 MB/s 不同,理论换算要除以 8:14 Mbps 约为 1.75 MB/s,实际还受网络和协议开销影响。月流量包的 GB 是累计传输量,不是速度。套餐剩余流量与超额规则在控制台确认。
| 频率 | 检查内容 | 发现异常时 |
|---|---|---|
| 日常使用 | 页面可用、问答 / 资料引用是否正常 | 记录时间和具体请求,再按故障链路排查 |
| 每周 | 磁盘、内存、错误日志、数据备份结果 | 确认大文件来源;清理前核对是否为业务数据 |
| 每月 | 流量与费用、证书续期、备份恢复抽查 | 补充告警与容量计划 |
| 更新前后 | 版本、恢复点、服务状态与功能验收 | 问题无法快速修复时使用已验证的回滚方案 |
| 到期前 | 服务器、域名与相关付费服务到期 | 核对续费状态、支付方式与通知联系人 |
云服务器套餐费、域名续费、模型调用费、CDN 流量和备份存储费是不同账单。启用一个服务前,先看当前计费规则和余额提醒。系统自带的 dpkg-db-backup 定时任务只备份软件包管理信息,不能当作你的业务数据库备份。
四种登录互相独立
| 登录 | 使用的身份 | 它授权你做什么 |
|---|---|---|
| 腾讯云控制台 | 腾讯云账号、微信 / 通行密钥等 | 购买和管理云资源 |
| SSH | ubuntu 账户 + SSH 私钥 | 管理服务器操作系统和文件 |
| 应用网页登录 | 应用账号或入口密码 | 控制谁能使用网页;目前两个应用入口密码已取消 |
| Codex CLI | ChatGPT 账号或相应 API 配置 | 授权 Codex 调用模型,与 SSH 不是同一次登录 |
这台服务器要不要装图形桌面?
当前三个项目都能通过网页使用,管理工作可通过 SSH 完成。图形桌面会增加资源占用、软件更新和远程桌面维护,当前没有必须安装的需求。
如果以后有依赖桌面的软件任务,再评估图形环境与远程桌面。Codex 的 Linux 桌面版目前为预览,官方列出 Ubuntu 24.04 / 26.04,但使用桌面应用仍需要图形环境,也不会替代账号登录和网络要求。
参考:Codex Linux 桌面版说明 ↗上手练习与速查:先做只读操作
按顺序完成,熟悉自己的服务器;下面的勾选只记录学习进度。
一组只读巡检命令
whoami
pwd
readlink -f /srv/xunshan/current
systemctl is-active nginx xunshan-wechat xunshan-knowledge xunshan-qdrant postgresql@17-main
sudo ss -lntp
df -h
free -h
curl -fsS http://127.0.0.1:8000/health
curl -fsS http://127.0.0.1:8010/api/ready命令读法速查
| 命令 / 符号 | 用途 | 常见误会 |
|---|---|---|
| pwd / ls / cd | 查看目录 / 列文件 / 切换目录 | cd 只改变终端位置,不移动文件 |
| sudo | 以管理员身份执行一条命令 | 不代表后面所有命令都自动提权 |
| systemctl status | 查看服务状态 | restart 才会重启;status 不会 |
| journalctl -u | 看指定服务日志 | -f 是持续显示新日志,Ctrl+C 停止查看 |
| curl | 发起网络请求 | 错误码要结合返回内容与日志看 |
| 127.0.0.1 | 当前机器自身 | 在你电脑输入时,指的是你的电脑 |
| && | 前一命令成功后才执行后一条 | 常用于检查配置通过后再 reload |
| 路径与大小写 | 定位文件与目录 | Linux 大小写敏感,空格路径需正确引用 |
这份手册如何使用与核对
这是一份可离线打开的单文件 HTML,目录、搜索、流程图、答题和学习勾选都在本机运行。复制按钮只复制文字,不会自动执行命令。学习进度保存在当前浏览器,换浏览器或清理网站数据后可能丢失。
本手册记录核对时间为 2026-10-05。套餐截图、部署记录和服务器只读检查用于描述你的配置;各章节的“参考”链接指向官方资料。你以后修改服务器后,应相应更新这些记录。界面位置、计费和支持版本以服务商最新说明为准。
手册没有嵌入 SSH 私钥内容、API 密钥、账号令牌或旧的网页登录密码。它包含实例名、IP、目录与域名,适合你和负责维护的同事学习使用。