Linux 开发路径约定（SSOT）

生效日期: 2026-06-04
取代各 handoff 文档中的 C:\Users\... / /mnt/c/... 示例。

工作区

变量	示例
`NEXUS_ROOT`	`~/Nexus` 或 `/home/you/Nexus`
Git 克隆	`git clone http://66.154.115.8:3000/admin/Nexus.git "$NEXUS_ROOT"`（匿名，无需令牌）

Git push

git clone / git pull：公共仓库可匿名。
git push：bash scripts/git-push.sh（读取 deploy/nexus-1panel.secrets.sh 中的 NEXUS_GITEA_TOKEN，即 admin 密码；该文件不入 git）。
应用密钥仍在 .env，与 Gitea 无关。

SSH / 部署

用途	Linux
SSH 目标	`azureuser@20.24.218.235`（生产 VPS）
私钥	本机路径写在 `deploy/nexus-1panel.secrets.sh` 的 `NEXUS_SSH_KEY`（不入 git）
一键部署	`bash deploy/pre_deploy_check.sh && bash deploy/deploy-production.sh`（自动 source secrets）
生产目录	`/opt/nexus`（Docker）或 `/www/wwwroot/api.synaglobal.vip/`（Supervisor）

# secrets 已配置时无需 export；否则：
# export NEXUS_SSH=azureuser@20.24.218.235
# export NEXUS_SSH_KEY='/path/to/nz-admin.pem'
bash deploy/deploy-production.sh

Cursor MCP

MySQL：scripts/linux_mcp_mysql.sh（见 docs/project/mysql-mcp-setup.md §4）
本地验证：bash scripts/local_verify.sh（见 docs/project/local-integration-test.md）
勿在 mcp.json 使用 wsl + Windows 路径（已废弃）

历史文档

docs/handoff-2026-05-31.md、AI-HANDOFF-2026-05-23.md 等保留 Windows 示例作归档；以本文 + AI-HANDOFF-2026-06-03.md 为准。

本地验收账号

# .env（不入 git）
NEXUS_TEST_ADMIN_USER=admin
NEXUS_TEST_ADMIN_PASSWORD='你的本地密码'

python3 scripts/seed_local_admin.py   # 仅空库 + 127.0.0.1
cd frontend && NEXUS_E2E_BASE=http://127.0.0.1:8600 npm run test:e2e

1.9 KiB Raw Permalink Blame History Unescape Escape

Linux 开发路径约定（SSOT）

工作区

Git push

SSH / 部署

Cursor MCP

历史文档

本地验收账号

1.9 KiB

Raw Permalink Blame History