寻山 · 云端手册
给寻山生物的一份实用指南

把服务器用明白

从看懂一台远程电脑,到自己检查运行状态。用你的官网、农业知识库和微信运营助手,把域名、SSH、部署与维护串起来。

12 课 · 可离线阅读 · 命令标注执行环境 · 配置核对:2026-10-05
第 01 课

先看懂:你的项目怎样运行

先知道每个部件干什么,再学按钮和命令。

服务器是一台租用的远程电脑。腾讯云提供计算、磁盘和网络;你负责安装应用、管理资料、更新代码和维护运行环境。轻量应用服务器采用较简化的套餐与控制台,适合你目前的网站和应用部署。

你的电脑

编辑代码、打开浏览器、通过 SSH 管理服务器。你电脑上的 Docker 可以关闭。

腾讯云服务器

持续运行官网、农业知识库、微信运营助手,并保存它们的数据。

模型服务商

接收应用发出的模型请求,完成问答、写作或嵌入计算,按相应规则计费。

点一个入口,看看请求去哪里

https://xunshanshengwu.cn/
你 / 同事的浏览器发起访问
DNS 查地址192.144.189.143
防火墙 · HTTPSTCP 443 / 加密连接
Nginx 分流根据域名选择应用
官网文件/srv/xunshan/current/website

Nginx 直接返回 HTML、图片、CSS 和 JavaScript,无需 Python 后台。

DNS 先帮助浏览器找到 IP;建立 HTTPS 连接时浏览器发送域名信息,Nginx 选择相应证书和站点,再返回网页或转发到后台。三个域名可以共用一个 IP,同时显示不同内容。

名词它负责什么在你这里是什么
域名 / DNS用容易记的名字找到服务器三个入口都指向同一个公网 IP
端口区分网络服务的入口22 管理、80 HTTP、443 HTTPS
Nginx提供官网文件、转发应用请求三个域名的统一入口
systemd启动服务、管理进程和开机运行让后台不依赖你开着终端窗口
PostgreSQL / SQLite保存结构化业务记录知识库与运营助手使用的数据库
Qdrant 向量库找出与问题含义相近的资料片段农业知识库的检索组件
想一想:两个域名指向同一个 IP,会只能打开同一个网站吗?

参考:Nginx 官方入门指南 ↗
回到页首 ↑
第 02 课

你的服务器:配置与项目位置

这部分是本次部署的实际记录,不是通用示例。

实例 / 服务器Ubuntu-FMjslhins-kiu7hw20 · 北京
公网 IPv4192.144.189.143Ubuntu 24.04 · x64
套餐截图配置4 核 / 16 GB220 GB SSD · 14 Mbps 带宽

配置来自你的控制台截图和部署检查。截图中的流量包为 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 服务,未在本次检查中确认。
  • 云控制台备份设置:本机部署记录不能证明控制台是否开启系统盘自动备份,要到腾讯云控制台查看。
回到页首 ↑
第 03 课

控制台上的按钮:什么时候用

腾讯云控制台管理云资源;项目的日常使用从应用域名进入。

进入 腾讯云控制台 → 轻量应用服务器 → 服务器 → Ubuntu-FMjs。界面可能随版本调整,可按这些功能名称寻找对应入口。

入口 / 按钮用途与操作对项目的影响
概要查看 IP、运行状态、套餐和到期日查看不影响运行
监控查看 CPU、内存、磁盘、带宽与流量曲线查看不影响运行
登录 / OrcaTerm打开云端终端,执行 Linux 命令打开终端不等于重启服务器
防火墙添加或编辑允许进入的端口和来源规则立即影响访问;无需为此重启
SSH 密钥管理连接服务器用的密钥与实例绑定绑定方式可能触发关机、开机,应先看提示
重置密码修改操作系统账户密码改变服务器密码登录凭据;具体生效过程看确认页
文件管理上传、下载、编辑服务器文件改运行中的代码和资料前先备份
重启整个系统重新启动所有项目短暂中断;要检查服务是否恢复
关机 / 开机停止 / 启动服务器系统关机后网站和应用停止响应;计费以套餐规则为准
快照 / 云硬盘备份保存磁盘某个时刻的状态回滚整盘会影响代码、配置和业务数据
续费 / 升级套餐保持资源有效、调整配置涉及费用;升级过程是否中断看操作页说明
重装系统 / 销毁实例重新初始化系统 / 移除云资源属于高影响操作,先核对实例、导出数据与恢复方法

做一次控制台巡检

  1. 核对实例名、IP 与北京地域,确认正在查看正确的机器。
  2. 看运行状态和到期日,再看本月流量与近期带宽峰值。
  3. 查看监控趋势:CPU 持续升高、内存不足或磁盘接近满时,先找具体服务和日志。
  4. 进入快照 / 云硬盘页面,核对最近备份时间、保留期限和当前配额。
  5. 完成检查后直接离开控制台,项目会继续由服务器运行。
每次扫码登录麻烦,怎么减少?

电脑微信已登录并绑定同一腾讯云账号时,可以尝试微信快捷登录。也可以在账号中心的安全设置中创建通行密钥,用设备 PIN、指纹等完成验证,额外登录保护仍可能要求二次验证。

登录状态管理可调整最大保持时间(最多 72 小时)与无操作保持时间(最多 48 小时),修改后下一次登录生效。关闭浏览器就掉登录时,检查是否用了无痕窗口或自动清理 Cookie。

参考:腾讯云登录方式 ↗参考:创建通行密钥 ↗参考:设置登录保持时间 ↗
参考:实例防火墙 ↗参考:SSH 密钥绑定 ↗参考:重装系统的影响 ↗
回到页首 ↑
第 04 课

SSH:从你的电脑管理服务器

先分清“在 Windows 输入”与“登录后在 Linux 输入”。

SSH 是加密的远程管理连接。你使用本机私钥证明身份,服务器核对对应公钥;登录后,输入的命令就在远程 Ubuntu 上执行。HTTPS 是网页连接,SSH 是管理连接,二者各自运行。

第一步:在 Windows PowerShell 连接

本机 · Windows PowerShell建立 SSH 连接
ssh -i "C:\xunshanshengwu.pem" ubuntu@192.144.189.143

-i 后面是本机私钥文件路径;ubuntu 是远程用户名;@ 后面是服务器 IP。这里默认使用 22 端口。命令里的引号是 PowerShell 的路径语法;在应用的“身份文件路径”输入框通常填写纯路径即可。

第二步:确认你已进入远程机器

服务器 · SSH 登录后的 Linux只读查看
whoami
pwd
hostname

whoami 应显示 ubuntu;pwd 显示远程当前目录;hostname 显示服务器主机名。终端通常出现 ubuntu@…:~$,接下来用的是 Linux 命令。

第三步:查看项目目录

服务器 · SSH 登录后的 Linux只读查看
ls -lah /srv/xunshan/current/
readlink -f /srv/xunshan/current

ls 查看文件列表;readlink -f 查看 current 实际指向哪个版本。sudo 表示以管理员权限执行某条命令,权限越高,操作前越要确认路径与影响。

第四步:退出连接

服务器 · SSH 登录后的 Linux关闭当前 SSH 会话
exit

退出 SSH 会话不会停止由 systemd 管理的项目。实时查看日志时按 Ctrl + C 结束“跟随日志”,也不会关闭应用。

上传与下载:SCP

下面是示例,需要把本地包路径和远程文件名换成实际文件。先传到暂存位置,再按部署流程发布,避免上传旧数据覆盖同事刚写入的记录。

本机 · Windows PowerShell示例:上传部署包,路径需替换
scp -i "C:\xunshanshengwu.pem" "E:\你的项目\release.tar.gz" ubuntu@192.144.189.143:/tmp/release.tar.gz

下载时调换来源和目标。例如下载管理员已生成的备份文件:

本机 · Windows PowerShell示例:下载备份,远程文件需替换
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 管理仍可使用。

你电脑上的代理不会自动改变服务器的网络出口;服务器自身访问模型服务的能力,需要单独核对。安装图形桌面也不会自动解决账号登录问题。

回到页首 ↑
第 05 课

域名、防火墙、HTTPS:三个独立步骤

把“能找到服务器”“能连进去”“网页加密”分别配置。

域名解析:添加 A 记录

进入 腾讯云云解析 DNS / DNSPod → 权威解析 → xunshanshengwu.cn → 记录管理 → 添加记录。轻量云的域名页面也能引导添加解析。下面是你现有域名对应的设置:

主机记录记录类型线路记录值结果
@A默认192.144.189.143主域名官网
wwwA默认192.144.189.143www 官网入口
kbA默认192.144.189.143知识库子域名
wechatA默认192.144.189.143运营助手子域名

@ 代表域名本身,kb 代表子域名前缀。A 记录对应 IPv4;AAAA 对应 IPv6;CNAME 对应另一个域名。修改后可能暂时受到 DNS 缓存影响,先查解析结果。没有部署 IPv6 服务时,先不要额外添加 AAAA。

本机 · Windows PowerShell只读查看
Resolve-DnsName kb.xunshanshengwu.cn -Type A
参考:腾讯云 A 记录 ↗

防火墙:让指定入口可以进入

进入实例的防火墙 → 添加规则,填写协议、端口、来源和允许策略。已有正确规则时不用重复添加。

端口 / 协议用途在当前架构中的处理
22 / TCPSSH 管理供管理员连接;缩小来源前先确认自己的出口 IP 和备用登录方式
80 / TCPHTTP 跳转、证书校验保留公网可达,供当前 HTTP-01 证书验证使用
443 / TCPHTTPS 网页对访问网站和应用的用户开放
8000、8010两个 Python 后台绑定 127.0.0.1,由 Nginx 转发,无需开放公网
5432、6333、6334PostgreSQL、Qdrant保持仅服务器本机可访问;应用通过本机连接

0.0.0.0/0 表示所有 IPv4 来源,不表示仅公司访问。云防火墙、操作系统防火墙、服务监听地址都会影响访问;打开云端端口也不能让绑定 127.0.0.1 的服务直接从公网访问。

本机 · Windows PowerShell只读查看
Test-NetConnection 192.144.189.143 -Port 443

看输出中的 TcpTestSucceeded。它只证明 TCP 可以连接,不证明域名、证书和业务功能全部正常。

HTTPS:证书与自动续期

  1. 先让所需域名解析到服务器,并确认 HTTP 80 端口可以访问。
  2. 配置 HTTP 验证路径,让 /.well-known/acme-challenge/ 可以返回证书验证文件。
  3. 使用 Certbot 申请包含所需域名的证书,并把证书路径配置到 Nginx。
  4. 检查配置、加载 HTTPS 443 站点,然后设置 HTTP 跳转。
  5. 启用定时续期,并验证续期成功后 Nginx 会重新加载新证书。

这套已经配好,日常主要是查看与验证,不需要反复申请新证书:

服务器 · SSH 登录后的 Linux查看证书与续期定时器
sudo certbot certificates
systemctl status certbot.timer --no-pager
服务器 · SSH 登录后的 Linux续期模拟验证,会联系证书测试服务
sudo certbot renew --cert-name xunshan-internal --dry-run

HTTPS 通过证书和握手保护浏览器到服务器的连接;网页登录密码负责限制访问者。取消密码后,HTTPS 仍可正常加密。

参考:Certbot 续期说明 ↗

CDN 放在哪一层?

CDN 可在用户和源服务器之间缓存静态资源。接入时通常由服务商提供 CNAME,再设置回源与 HTTPS。官网的图片、CSS、JS 可按需要加速;知识库的私人响应、问答接口、设置和运营数据应绕过共享缓存。你当前三个域名尚未接入 CDN,先把直接访问和维护流程用熟即可。

参考:CDN 缓存与登录场景 ↗参考:轻量服务器 ICP 备案 ↗
回到页首 ↑
第 06 课

部署一个项目:按这个顺序做

部署包括代码、运行环境、配置、数据、常驻服务和对外入口。

把文件传上服务器只是其中一步。以下是以后部署或迁移新项目时可复用的流程;你现有三个项目已经完成部署,无需从头重做。

  1. 盘点项目需要什么

    写清:启动命令、Python / Node 版本、依赖文件、环境变量、数据库、上传资料目录、向量集合、应用端口,以及首页 / 健康检查地址。确认外部模型服务从服务器能够访问。

  2. 核对目标机器,并先备份

    确认实例名和 IP。保存当前代码、Nginx / systemd 配置,并对运行中的数据库和向量集合使用一致性备份方式。记录当前版本,以便出问题时恢复。

  3. 准备新的版本目录

    采用“每次发布一个新目录,再切换 current”的方式。例如 /srv/xunshan/releases/新的发布时间。新版本未验证前,先保持旧版本运行;运行数据最好长期独立存放,不跟着版本目录被替换。

  4. 上传需要的代码和资源

    静态官网通常上传 HTML、CSS、JS、图片,或构建后的 dist / build。Python 应用上传代码与依赖描述。通常排除 .git、本机虚拟环境、node_modules、缓存和临时文件;凭据走单独的受控配置流程。

  5. 在 Linux 上建立运行环境

    创建项目专用虚拟环境,安装已核对版本的依赖;有前端构建时运行相应构建步骤。Windows 的虚拟环境与本机二进制不能直接搬来当 Linux 环境使用。

  6. 配置账户、权限和环境变量

    用专用应用账户运行服务,设置正确目录、工作路径与文件权限。模型 API 密钥、数据库密码留在服务器配置中,前端 HTML / JS 不放这些凭据;也不要打包进公开网页目录。

  7. 迁移业务数据,再核对

    数据库迁移要匹配程序版本与表结构。向量库可以恢复快照;核对集合名、数量、向量维度、距离类型、嵌入模型与索引配置。不要把“上传源码”当成“上传了向量库”。

  8. 先在服务器本机启动与检查

    后台先绑定 127.0.0.1。验证首页、健康接口、数据库和向量检索依赖。执行写入、嵌入或付费模型功能前,应知道会改哪些数据、用多少额度。

  9. 交给 systemd 常驻运行

    服务文件中写清应用账户、工作目录、启动命令和重启策略;启用开机运行。终端里直接启动一个进程,并不自动具备断线后运行与开机启动的保障。

  10. 配置 Nginx、域名、防火墙和 HTTPS

    Nginx 静态站点指向官网目录,应用站点转发到对应后台。先完成 DNS 与 HTTP 校验,再配置 HTTPS;最后按实际使用范围设置访问方式。

  11. 从使用者电脑完成验收

    检查域名解析、证书、跳转、页面与静态资源;验证一次真实业务路径,区分“网页能打开”和“模型功能可用”。会产生费用或写入的数据测试,要控制范围并记录结果。

  12. 记录版本、验证结果和恢复方法

    保存部署说明、代码版本、数据库迁移记录、备份位置和回滚路径。切换后观察服务日志,确认旧数据没有被覆盖、定时任务没有重复启动。

先做低成本健康检查

服务器 · SSH 登录后的 Linux只读查看
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。

示例 · systemd .service 文件教学模板,不能原样用于现有项目
[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.target
参考:systemd 服务配置 ↗
Nginx 是怎样根据域名转发的?

示意配置中的 server_name 匹配知识库域名,proxy_pass 指向本机知识库进程。完整配置还包含 TLS、转发头、超时、上传大小、缓存和 HTTP 验证路径。

示意 · Nginx 配置片段片段不完整,仅用于理解
server {
    listen 443 ssl;
    server_name kb.xunshanshengwu.cn;
    # 此处还要配置证书等内容
    location / {
        proxy_pass http://127.0.0.1:8010;
    }
}
回到页首 ↑
第 07 课

以后修改项目:备份、发布、验证、回滚

小修改也要知道改的是代码、配置,还是运行中的数据。

修改对象通常要做什么怎样确认生效
官网文字 / 图片更新相应静态资源;有构建流程时先构建打开对应页面,检查图片、链接与缓存
知识库 / 助手代码发布新版本,必要时更新依赖,再重启对应应用健康接口、日志、被修改的功能
模型 / 数据库配置更新服务端配置,重启读取这些配置的应用确认相应连接与功能;凭据不写进日志
Nginx 域名 / 转发配置备份配置、检查语法、reload公网域名与后台访问分别检查
systemd 服务文件修改后 daemon-reload,再重启对应服务服务状态、启动日志与开机启用状态
数据库结构 / 向量索引单独设计迁移、备份、兼容与恢复方案数量、结构、检索结果和业务功能

一次更新的实际步骤

  1. 明确要改变的页面或功能,并在本机源码保留同一份修改。
  2. 记录当前版本和相关配置,做受影响数据的备份。
  3. 在新版本目录准备代码、依赖和配置;有必要时用单独测试端口验证。
  4. 先检查,再切换版本或替换已备份的小文件;避免覆盖线上新增资料、数据库和输出。
  5. 只加载 / 重启需要更新的组件,查看日志与健康接口。
  6. 从浏览器验证目标功能与原有功能;有缓存时刷新正确页面。
  7. 失败时恢复旧配置 / 旧代码版本,重新验证。保留失败日志以便继续诊断。

重新加载 Nginx

服务器 · SSH 登录后的 Linux修改生效:仅语法检查成功才重新加载
sudo nginx -t && sudo systemctl reload nginx

nginx -t 检查配置语法和引用文件。&& 表示前一步成功后才执行下一步。reload 可让 Nginx 加载新配置,正常情况下不需要重启整台机器。

重启单个应用

服务器 · SSH 登录后的 Linux会短暂中断农业知识库
sudo systemctl restart xunshan-knowledge
服务器 · SSH 登录后的 Linux只读查看
systemctl 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。

服务器 · SSH 登录后的 Linux加载服务定义后重启知识库
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/
回到页首 ↑
第 08 课

Docker、数据库、向量库:分清关系

Docker 是一种运行与打包方式,应用和数据库也能直接在 Linux 运行。

原生部署

在 Linux 上直接安装软件。Python 用虚拟环境隔离依赖,systemd 管理服务。你服务器目前使用这种方式。

Docker 部署

把程序和运行环境装进镜像,再启动容器。数据库的持久数据需通过卷或挂载保存。

两种方式都能部署

根据项目维护方式选择。换成 Docker 需要重新安排网络、配置和数据挂载,不只是点击一个开关。

Docker 里常见的四个词

词含义你要记住的点
镜像 Image程序和环境的可复用模板镜像不等于业务数据备份
容器 Container从镜像启动的运行实例能启动、停止、重建
数据卷 Volume独立保存持久文件的位置数据库数据应持久保存;删除卷可能丢数据
Compose 项目把多个相关服务按配置一起管理Docker Desktop 中的折叠分组可能是一整套应用
参考:Docker 官方基础概念 ↗

数据库和向量库在农业知识库中做什么

普通数据库保存结构化记录,例如资料信息、任务状态和会话记录;向量库保存用于相似性检索的向量与片段关联信息。两者互相配合,也要与原始资料和索引 manifest 对得上。

问答流程通常是:接收问题 → 找相关资料片段 → 组织提示 → 调用模型 → 返回结果与引用。部分流程还会为问题生成查询向量,具体取决于应用实现与配置。

现在可以查看实际监听地址

服务器 · SSH 登录后的 Linux只读查看
sudo ss -lntp

127.0.0.1:8010 表示只有服务器本机可连知识库后台;0.0.0.0:443 表示 Nginx 在所有 IPv4 网络接口上监听,公网能否进入还取决于防火墙与网络。日志里出现进程名称和端口,不代表已对所有用户开放。

想一想:服务器没有 Docker,Qdrant 就不能运行吗?

回到页首 ↑
第 09 课

备份与恢复:保存能重新运行的一整套东西

有代码副本,不等于有最新业务数据;有备份,也要确认能恢复。

你的项目已经有初始迁移备份,位置为 /srv/xunshan/backups/20261004-initial/,后续配置操作也保存了手工备份。目前没有项目定时数据备份任务。同一台服务器上的备份能应对部分误操作,但服务器或磁盘出问题时,需要另一处副本。

备份对象应包含什么恢复时注意
代码与依赖发布版本、依赖清单、启动方式知道哪个版本与数据结构匹配
应用配置环境变量、服务文件、Nginx 配置包含密钥的副本仅管理员可读,不放进网站目录
微信助手 SQLite一致性数据库备份、资料和输出文件运行中不能只随手复制主数据库文件,可能还有 WAL 数据
知识库 PostgreSQL数据库导出、所需角色与扩展信息用数据库工具恢复;确认版本、连接配置与权限
知识库 Qdrant集合快照、集合名与嵌入模型信息恢复后核对数量、维度和检索结果
原始资料与 manifest上传资料、索引映射、相关文件元信息与数据库和向量集合对应,避免引用断链

应用数据备份:六步流程

  1. 记录备份范围与时间

    写清发布版本、数据库和集合名称。为需要相互对应的数据设置一致的备份窗口,必要时暂停资料导入等写入任务。

  2. 用对应工具生成数据副本

    PostgreSQL 使用 pg_dump 等数据库备份工具;SQLite 使用在线备份接口或 .backup;Qdrant 使用集合快照。Qdrant 的单个集合快照不等于整套项目备份。

  3. 保存资料与配置

    将原始文件、manifest、依赖清单和启动配置放入同一个有日期的备份目录。密钥与普通代码分开保管。

  4. 核对副本

    确认文件存在、大小合理、生成过程没有报错。保存校验值;数据库导出可核对对象列表,向量快照记录数量和维度。

  5. 复制到服务器外

    下载到受保护的公司电脑或专用备份存储。含客户资料或 API 密钥的备份,应限制访问并加密保存。

  6. 试恢复后再清理旧备份

    在临时目录、临时数据库和新的向量集合中恢复,做一次检索与资料引用检查。验证通过后按保留规则清理过期副本。

参考:PostgreSQL 数据导出备份 ↗参考:SQLite 在线备份 ↗参考:Qdrant 快照与恢复 ↗

云快照 / 系统盘备份:另一层保护

腾讯云磁盘快照保存整块磁盘某个时刻的状态,适合重大升级前留一份恢复点。系统盘自动备份则要在控制台核对是否启用、最近备份时间、保留策略和费用。两者不能替代数据库的一致性备份。

  1. 控制台打开正确实例的快照 / 云硬盘备份页面,查看可选磁盘、配额、费用与保留期限。
  2. 重大改动前创建恢复点,并另外导出关键应用数据。
  3. 需要回滚时,先保存当前新增资料,再核对恢复点时间与磁盘范围。
  4. 按控制台流程回滚,准备整个实例短暂中断;恢复后检查项目、证书、数据与域名。
参考:轻量服务器快照 ↗参考:系统盘自动备份 ↗

建议的维护计划(尚未配置)

可从“每日数据备份 + 重大更新前备份 + 定期服务器外副本 + 每月恢复抽查”开始,再按数据量和可接受的数据损失调整频率与保留天数。Linux 的 systemd timer 或 cron 能按时运行备份脚本;只有任务实际配置并验证成功,才算自动备份已完成。

回到页首 ↑
第 10 课

打不开时:按链路逐层排查

先确定故障在哪一层,避免把所有问题都当成服务器坏了。

从外向内检查:域名解析 → 网络端口 → 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 / 504Nginx 无法正常得到后台响应先请求本机健康接口,再看服务状态、应用日志与 Nginx 错误日志
页面正常,模型调用失败网页入口正常,但模型链路出错看模型请求错误、服务器网络出口、配置、额度与服务商支持范围
检索无结果 / 引用失效索引、资料或数据关联可能不一致检查集合名称、嵌入维度、manifest 与原始文件;先避免重新导入覆盖
重启后项目不恢复开机启动或依赖存在问题检查 systemd 是否 enabled,再检查数据库和应用启动日志

区分“页面通了”与“功能真的完成”

微信助手的 /health、知识库的 /api/ready 返回正常,证明相应检查通过;它不保证外部模型可用、所有资料能检索或公众号发布成功。功能验收需分别检查真实检索、引用和模型调用。付费模型测试应限制次数与输入规模。

求助时提供这些信息

发出故障时间、完整网址、具体操作、错误文字、最近改动,以及已脱敏的相关日志。不要把私钥文件内容、API 密钥、Cookie 或令牌贴进聊天和截图。

回到页首 ↑
第 11 课

日常维护:看状态、资源、日志和费用

先学会观察运行状态,再安排可控的维护窗口。

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

查看服务是否运行、是否开机启动

服务器 · SSH 登录后的 Linux只读查看
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-main

active 表示当前运行;enabled 表示已设置随系统启动。二者不同:一个服务可以正在运行,但没有配置开机启动。

看最近日志与实时日志

服务器 · SSH 登录后的 Linux只读查看
sudo journalctl -u xunshan-knowledge -n 80 --no-pager
sudo tail -n 50 /var/log/nginx/error.log
服务器 · SSH 登录后的 Linux实时看日志,Ctrl+C 退出查看
sudo journalctl -u xunshan-knowledge -f

看磁盘、内存和负载

服务器 · SSH 登录后的 Linux只读查看
df -h
free -h
uptime

df -h 看磁盘容量与占用;free -h 看内存,重点看 available,不要只看 free;uptime 看开机时间与负载。想看实时进程可以输入 top,按 q 退出。

带宽 Mbps 与文件速度 MB/s 不同,理论换算要除以 8:14 Mbps 约为 1.75 MB/s,实际还受网络和协议开销影响。月流量包的 GB 是累计传输量,不是速度。套餐剩余流量与超额规则在控制台确认。

频率检查内容发现异常时
日常使用页面可用、问答 / 资料引用是否正常记录时间和具体请求,再按故障链路排查
每周磁盘、内存、错误日志、数据备份结果确认大文件来源;清理前核对是否为业务数据
每月流量与费用、证书续期、备份恢复抽查补充告警与容量计划
更新前后版本、恢复点、服务状态与功能验收问题无法快速修复时使用已验证的回滚方案
到期前服务器、域名与相关付费服务到期核对续费状态、支付方式与通知联系人

云服务器套餐费、域名续费、模型调用费、CDN 流量和备份存储费是不同账单。启用一个服务前,先看当前计费规则和余额提醒。系统自带的 dpkg-db-backup 定时任务只备份软件包管理信息,不能当作你的业务数据库备份。

四种登录互相独立

登录使用的身份它授权你做什么
腾讯云控制台腾讯云账号、微信 / 通行密钥等购买和管理云资源
SSHubuntu 账户 + SSH 私钥管理服务器操作系统和文件
应用网页登录应用账号或入口密码控制谁能使用网页;目前两个应用入口密码已取消
Codex CLIChatGPT 账号或相应 API 配置授权 Codex 调用模型,与 SSH 不是同一次登录
这台服务器要不要装图形桌面?

当前三个项目都能通过网页使用,管理工作可通过 SSH 完成。图形桌面会增加资源占用、软件更新和远程桌面维护,当前没有必须安装的需求。

如果以后有依赖桌面的软件任务,再评估图形环境与远程桌面。Codex 的 Linux 桌面版目前为预览,官方列出 Ubuntu 24.04 / 26.04,但使用桌面应用仍需要图形环境,也不会替代账号登录和网络要求。

参考:Codex Linux 桌面版说明 ↗
参考:Ubuntu systemd 服务说明 ↗
回到页首 ↑
第 12 课

上手练习与速查:先做只读操作

按顺序完成,熟悉自己的服务器;下面的勾选只记录学习进度。

一组只读巡检命令

服务器 · SSH 登录后的 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
想一想:网址前面有 HTTPS,是不是只有公司同事能访问?

命令读法速查

命令 / 符号用途常见误会
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、目录与域名,适合你和负责维护的同事学习使用。

回到页首 ↑