# 一鹏云服务器环境确认

检查时间：2026-05-30 19:52–19:54 +08:00  
SSH 目标：`wwyl-cloud` / `wwyl.yipeng.online`（运维兼容 IP：`175.27.229.243`）  
本次动作：只读检查服务器环境；未创建数据库、未改 Nginx、未部署服务、未修改飞书业务数据。

## 结论摘要

该服务器可以承载财务管理平台的 Node.js + PostgreSQL 部署：

- 系统：Ubuntu 24.04.4 LTS，x86_64。
- Node.js：已安装 `v22.22.2`，npm `10.9.7`；未安装 pnpm。
- PostgreSQL：已安装并运行 PostgreSQL 16.14，5432 仅监听 `127.0.0.1`，适合作为本机后端服务的数据库。
- Web 入口：Nginx 已运行，80/443 开放；`wwyl.yipeng.online` 已配置 HTTPS。
- HTTPS 证书：CN=`wwyl.yipeng.online`，有效期 `2026-05-13` 至 `2026-11-13`。
- Docker：未安装；建议先用 systemd + Node 直接部署，低维护。
- 服务器权限：`ubuntu` 用户具备免密 sudo，可在确认后创建数据库/系统服务/Nginx 路由。

## 服务器基础信息

```text
whoami: ubuntu
hostname: VM-0-10-ubuntu
OS: Ubuntu 24.04.4 LTS (noble)
Kernel: Linux 6.8.0-101-generic x86_64
Uptime: 65 days
```

资源概况：

```text
Memory: 3.6Gi total, 2.2Gi used, 1.5Gi available, swap 1.9Gi total / 697Mi free
Disk /: 99G total, 26G used, 69G available, 28% used
```

## Node.js / 包管理

```text
node: /usr/bin/node v22.22.2
npm: /usr/bin/npm 10.9.7
pnpm: not installed
```

建议：当前项目是 npm workspace，直接使用 npm 即可，不必额外引入 pnpm。

## PostgreSQL

```text
psql: PostgreSQL 16.14 (Ubuntu 16.14-0ubuntu0.24.04.1)
pg_isready: /var/run/postgresql:5432 - accepting connections
systemd: postgresql@16-main active
cluster: 16/main online, port 5432, owner postgres
listen: 127.0.0.1:5432
```

现有非模板数据库：

```text
liangzhu_qianniu
postgres
```

现有可登录角色：

```text
postgres: superuser, createdb, login
qianniu_app: login only
```

建议后续为财务平台新建独立库和独立角色，例如：

```text
Database: studio_finance
Role: studio_finance_app
```

不要复用 `liangzhu_qianniu` 或 `qianniu_app`，避免业务混杂。

## Nginx / HTTPS / 端口

已启用站点：

```text
/etc/nginx/sites-enabled/ecommerce-pricing
/etc/nginx/sites-enabled/wwyl.yipeng.online-ssl
```

主域名配置：

```text
server_name wwyl.yipeng.online www.wwyl.yipeng.online
listen 80
listen 443 ssl http2
ssl_certificate /etc/nginx/ssl/wwyl.yipeng.online/fullchain.pem
```

证书：

```text
subject=CN = wwyl.yipeng.online
issuer=DigiCert Encryption Everywhere DV TLS CA - G2
notBefore=May 13 00:00:00 2026 GMT
notAfter=Nov 13 23:59:59 2026 GMT
```

Nginx 配置检查：

```text
nginx: configuration file /etc/nginx/nginx.conf test is successful
```

当前监听端口要点：

```text
0.0.0.0:22    SSH
0.0.0.0:80    Nginx HTTP
0.0.0.0:443   Nginx HTTPS
127.0.0.1:5432 PostgreSQL
127.0.0.1:3306 MySQL
127.0.0.1:8766 / 8777 / 8787 / 8101 / 18080 等已有本地服务
*:9377 Node 服务
```

建议财务平台后端内部监听一个新的 localhost 端口，例如 `127.0.0.1:8891`，再由 Nginx 挂到：

```text
https://wwyl.yipeng.online/finance/
```

或使用子域名（需额外 DNS/证书配置）：

```text
https://finance.wwyl.yipeng.online/
```

低维护优先建议第一版使用路径前缀 `/finance/`。

## 部署方式建议

鉴于 Docker 未安装、Nginx 与 PostgreSQL 已就绪，第一版建议：

1. 本地继续完成 Node/TypeScript 后端 + Prisma 模型。
2. 经用户确认后，在服务器创建独立 PostgreSQL 数据库和角色。
3. 将应用发布到 `/srv/studio-finance` 或 `/opt/studio-finance`。
4. 用 systemd 管理 Node 进程。
5. 用 Nginx 将 `/finance/` 反代到本地端口。
6. 飞书审批事件回调路径可预留为：
   `https://wwyl.yipeng.online/finance/api/feishu/approval/events`

## 本地项目当前验证

本地项目目录：

```text
/Users/bot1/Volumes/root_for_ai/AI工作区/公司财务_系统开发_财务管理平台_20260530_1748
```

本次同步验证：

```text
npm test        -> 3 files / 10 tests passed
npm run typecheck -> passed
npm run build     -> passed
```

## 下一步建议

不建议马上直接部署。下一步应先补齐最小后端骨架：

1. 增加 `apps/api`：Node HTTP API 服务，先做健康检查、财务核心只读接口、导出接口骨架。
2. 增加 Prisma 客户端和迁移策略：暂不连真实云库，先本地/测试环境验证 schema。
3. 增加部署模板：systemd service、Nginx location、`.env.example`。
4. 等用户确认后，再在云服务器创建真实数据库与部署目录。