PuppyIP 资源中心
云服务运维 10 分钟 发布于 2026-11-17

Ubuntu 原生部署 sd2api 并与 Sub2API 共存:隔离用户、端口与数据

sd2api 与已有 Sub2API 应分别使用独立用户、目录、端口和数据边界。浏览器或 VNC 页面可打开,不等于 API、数据库或真实账户流程通过验收。

sd2api Sub2API Ubuntu systemd SQLite PostgreSQL

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • 既有 Sub2API 的 PostgreSQL/Redis 与 sd2api 的 venv/SQLite 保持分离。
  • 独立目录和虚拟环境不会自动隔离端口、进程权限或资源。
  • CPUQuota=75%约为0.75逻辑CPU;700M/900M内存值仅作容量评估示例。
  • 浏览器、API、WebSocket/RFB、数据库和账户流程应分别核验。

先明确两种服务的运行边界

本文讨论 Ubuntu 上已有原生 Sub2API 服务,再加入 sd2api 的共存配置。前者使用 PostgreSQL 与 Redis;后者按所选公开版本使用独立 Python 环境和 SQLite。先核对各自版本,再为新服务划分独立用户、systemd unit、目录与监听端口。

sd2api 与 Sub2API 是不同项目,不应因为名称相近就混用安装说明、数据库或配置。保留既有 PostgreSQL/Redis 和应用数据,只为新服务配置所需依赖;升级时重新核对对应项目的公开文档。

读取既有 unit 并规划独立端口

创建新 unit 前,只读查看既有服务状态、工作目录、启动参数和 EnvironmentFile 位置;这类输出只在本地检查,因为可能包含内部路径或秘密引用。查看当前监听端口,再为新服务选一个未冲突端口。清楚区分浏览器入口、应用 API、数据库和 VNC/RFB 服务。

为 sd2api 创建独立系统用户与服务数据目录,限制该用户只访问自己的代码、虚拟环境和 SQLite 文件。Python 虚拟环境隔离的是依赖版本,不会隔离进程权限、CPU、内存、网络或数据库内容;两个目录不同也不保证端口或数据互相隔离。

只读查看既有 Sub2API unit 元数据

shell
SERVICE_UNIT=REPLACE_WITH_EXISTING_SERVICE_UNIT.service
sudo systemctl show "$SERVICE_UNIT" --property=LoadState,ActiveState,SubState,WorkingDirectory,ExecStart,EnvironmentFiles --no-pager
只读取 unit 元数据。输出可能暴露本地路径或参数,勿公开完整原始输出。

检查监听端口快照

shell
ss -ltn
只读端口快照。当前未监听不代表端口会一直空闲;先确认新服务计划端口和绑定地址。

将 venv 与 SQLite 放在新服务自己的数据边界内

在新服务用户拥有的目录创建 Python venv,再按 sd2api 对应固定版本的公开说明安装依赖。不要把包混装进系统 Python,也不要将 SQLite 文件放进 Sub2API 的 PostgreSQL/Redis 数据目录。SQLite 文件应使用受控权限和独立备份,并按该应用公开支持的数据库模式运行。

如果对应版本不支持 SQLite,或需要多进程并发写入,应停下来选用项目正式支持的独立数据库,不要临时把既有生产库共用给新应用。单独的 SQLite 数据文件也不能替代备份、迁移和文件访问控制。

在新服务拥有的目录创建 venv

shell
python3 -m venv REPLACE_WITH_SERVICE_OWNED_DIRECTORY/venv
在新服务用户可写的独立目录中执行;不会安装应用依赖。不要复用 Sub2API 或其他服务的虚拟环境。

先测量资源,再考虑 systemd 限制

先观察两种服务同时运行时的 CPU、内存、磁盘与重启情况,再考虑独立 systemd drop-in。CPUQuota=75% 将 CPU 时间限制在约一个逻辑 CPU 的 75%;MemoryHigh=700M 是内存回收和限速阈值,MemoryMax=900M 是硬上限,无法将内存控制在上限内时可能触发单元内 OOM 终止。这些是假设示例,不代表主机容量或通用推荐值。

内存上限可能导致回收、重启或任务失败,CPU 限制也会降低吞吐。应用前先核对可用内存与峰值,保存旧 unit 配置,在维护窗口只改变一个服务并保留回滚步骤。不要把相同数值同时套到多个服务或从短暂空闲状态推断容量。

示例 systemd drop-in 资源限制

ini
[Service]
CPUQuota=75%
MemoryHigh=700M
MemoryMax=900M
仅作示例,不证明任何主机容量:CPUQuota=75%约为0.75个逻辑CPU;700M/900M需结合可用内存、负载峰值和systemd行为评估。维护窗口应用并保留回退。

浏览器、API、数据库和 VNC 分别验收

先确认两个 systemd unit、监听端口和数据库分别符合预期,再检查 sd2api 的浏览器页面、只读 API、SQLite 文件权限与应用日志。Sub2API 页面或 API 正常不能证明 sd2api 已初始化;静态网页返回 HTTP 200 也不能证明后端已连接正确数据库。

使用 noVNC 时,浏览器页面、WebSocket 建立、RFB 握手和实际桌面画面是独立检查点。通过应用公开的安全入口,使用合成或获准的测试账户分别核验。页面能打开,不能据此认定账户登录、广告任务或下游业务已经成功。

回退只针对新服务和本次路由

若新服务不健康,只停止或恢复 sd2api 自己的 unit、数据目录和本次新增的入口路由。不要删除既有 Sub2API 数据库、Redis、其他应用文件、共享代理配置或管理通道。发生未知失败时先读取脱敏错误和服务状态,不重复安装器、不清空数据库,也不创建新账户试错。

最终验收应分别记录原服务和新服务的基线、版本、unit 状态、数据库状态、API 结果和浏览器/VNC 检查。单项成功不能替代完整验收;原始环境文件、身份凭据和私有主机信息不应进入文章或支持截图。

资料来源

常见问题

虚拟环境能隔离两个服务的 CPU、端口和数据库吗?

不能。venv 主要隔离 Python 包;服务用户、工作目录、监听端口、数据库文件和 systemd 资源限制需要分别配置。

示例 CPUQuota 和内存限制适用于我的服务器吗?

不能直接假定。75%约为一个逻辑 CPU 的0.75;700M/900M只是容量评估示例。需根据可用内存与负载评估,并准备维护窗口和回退。

网页返回 HTTP 200 就代表 VNC 或应用账户可用吗?

不代表。浏览器页面、API、WebSocket/RFB、认证与真实业务流程是不同验收点。