# 运维连接手册（本地 PostgreSQL + GCE）

本手册记录项目线上关键连接信息：
- 怎么连线上服务器；
- 怎么连服务器本地数据库（当前生产数据源）；
- 线上项目目录和常用排查命令。

## 0. 固定信息

- GCP Project ID: `gen-lang-client-0835616737`
- 线上 VM: `instance-20260221-064508`
- Zone: `asia-northeast1-b`
- 线上项目目录: `/home/fzq1228/Projects/arbitrage-engine`
- 线上数据库（服务器本地 PostgreSQL）
  - Host: `127.0.0.1`
  - Port: `5432`
  - DB: `arb_engine`
  - User: `arb`
  - Password: `arb_engine_2026`

## 1. 连接线上服务器（GCE）

### 1.1 先确认账号和项目

```bash
gcloud auth list --filter=status:ACTIVE --format='value(account)'
gcloud config get-value project
```

如需切项目：

```bash
gcloud config set project gen-lang-client-0835616737
```

### 1.2 SSH（推荐 IAP）

```bash
gcloud compute ssh instance-20260221-064508 \
  --zone asia-northeast1-b \
  --project gen-lang-client-0835616737 \
  --tunnel-through-iap
```

快速连通性测试：

```bash
gcloud compute ssh instance-20260221-064508 \
  --zone asia-northeast1-b \
  --project gen-lang-client-0835616737 \
  --tunnel-through-iap \
  --command "hostname; whoami; uptime; pwd"
```

## 2. 连接服务器本地数据库（当前生产）

### 2.1 在服务器内直接 psql

```bash
sudo -u fzq1228 bash -lc "export PGPASSWORD=arb_engine_2026; psql -h 127.0.0.1 -U arb -d arb_engine -c 'SELECT now();'"
```

进入交互式：

```bash
sudo -u fzq1228 bash -lc "export PGPASSWORD=arb_engine_2026; psql -h 127.0.0.1 -U arb -d arb_engine"
```

### 2.2 从本机临时连（SSH Tunnel）

如果需要在本机 SQL 客户端查看：

```bash
# 本机开隧道
 gcloud compute ssh instance-20260221-064508 \
  --zone asia-northeast1-b \
  --project gen-lang-client-0835616737 \
  --tunnel-through-iap \
  -- -N -L 9432:127.0.0.1:5432
```

新开终端连本地映射端口：

```bash
PGPASSWORD=arb_engine_2026 psql -h 127.0.0.1 -p 9432 -U arb -d arb_engine -c "SELECT 1;"
```

## 3. 线上项目目录与运行状态

- Repo root: `/home/fzq1228/Projects/arbitrage-engine`
- Backend: `/home/fzq1228/Projects/arbitrage-engine/backend`
- Frontend: `/home/fzq1228/Projects/arbitrage-engine/frontend`
- 运行用户：`fzq1228`
- 进程管理：`pm2`

常用检查：

```bash
cd /home/fzq1228/Projects/arbitrage-engine
pm2 list
pm2 logs --lines 100
```

重点进程：
- `signal-engine`
- `paper-monitor`
- `arb-api`
- `agg-collector`
- `market-collector`
- `liq-collector`
- `position-sync`
- `risk-guard`

## 4. 版本同步

查看服务器分支和提交：

```bash
sudo git -c safe.directory=/home/fzq1228/Projects/arbitrage-engine \
  -C /home/fzq1228/Projects/arbitrage-engine rev-parse --abbrev-ref HEAD
sudo git -c safe.directory=/home/fzq1228/Projects/arbitrage-engine \
  -C /home/fzq1228/Projects/arbitrage-engine log --oneline -1
```

服务器拉代码：

```bash
cd /home/fzq1228/Projects/arbitrage-engine
git pull origin codex/codex_dev
```

## 5. 常见故障排查

- API 正常但策略不出信号：
  - 看 `signal-engine` 日志；
  - 检查 `strategies.status='running'`；
  - 检查 `signal_indicators` 最近 5 分钟是否持续写入。
- 有信号但不开仓：
  - 查 `paper_trades` 是否达到 `max_positions`；
  - 查 `flip_threshold/entry_score` 是否过高；
  - 查 `paper_monitor` 和 `signal_engine` 日志是否有拒绝原因。
- 数据断流：
  - 检查 `agg_trades` 最新 `time_ms`；
  - 检查 `agg-collector`、`market-collector`、`liq-collector` 进程。