diff --git a/.obsidian/plugins/obsidian-git/data.json b/.obsidian/plugins/obsidian-git/data.json index f5efe68..b4a8bc4 100644 --- a/.obsidian/plugins/obsidian-git/data.json +++ b/.obsidian/plugins/obsidian-git/data.json @@ -3,7 +3,7 @@ "autoCommitMessage": "vault backup: {{date}}", "commitMessageScript": "", "commitDateFormat": "YYYY-MM-DD HH:mm:ss", - "autoSaveInterval": 1, + "autoSaveInterval": 10, "autoPushInterval": 0, "autoPullInterval": 0, "autoPullOnBoot": false, diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json index 6dbdfb3..7ee3c06 100644 --- a/.obsidian/workspace.json +++ b/.obsidian/workspace.json @@ -13,12 +13,12 @@ "state": { "type": "markdown", "state": { - "file": "工具相关/NewAPI搭建与上线完整实战指南.md", + "file": "日常文档/obsidian学习.md", "mode": "source", "source": false }, "icon": "lucide-file", - "title": "NewAPI搭建与上线完整实战指南" + "title": "obsidian学习" } }, { @@ -216,10 +216,12 @@ }, "active": "bf2a0beebbd3d1e9", "lastOpenFiles": [ + "日常文档/AI Agent发展趋势分析：Coding Agent成为AGI突破口.md", + "工具相关/NewAPI搭建与上线完整实战指南.md", + "工具相关/Gitea部署与Obsidian自动备份.md", "工具相关/www.md", "项目文档/徐工/蓝牙/徐工项目软件烧录文档.pdf.ldenc", "工具相关/CPA部署全流程.md", - "工具相关/NewAPI搭建与上线完整实战指南.md", "AI/AI应用开发.md", "日志/2026/日志11月.md", "工具相关/NEWapi.md", @@ -252,8 +254,6 @@ "项目文档/徐工/语音.md", "项目文档/徐工/优化开机速度.md", "项目文档/徐工/蓝牙/bluetooth_git_summary.md", - "项目文档/徐工/蓝牙/蓝牙模块流程概览.md", - "项目文档/徐工/蓝牙/蓝牙模块开发熟悉手册.md", "42d68e79e0122117fc941868202bfc9d.png", "项目文档/犀重/升级流程图.jpg", "工具学习/redmine_stats/tongli_stats.png", diff --git a/工具相关/Gitea部署与Obsidian自动备份.md b/工具相关/Gitea部署与Obsidian自动备份.md new file mode 100644 index 0000000..a4d5e07 --- /dev/null +++ b/工具相关/Gitea部署与Obsidian自动备份.md @@ -0,0 +1,178 @@ +# Gitea 部署与 Obsidian 自动备份 + +> 完成时间：2026-11-05 +> 服务器：腾讯云新加坡 43.156.118.130（Ubuntu 24.04） +> 用途：私人代码仓库 + Obsidian 笔记自动备份，替代被封的 GitHub 账号 + +--- + +## 一、Gitea 是什么 + +自己服务器上的私人 GitHub：存代码、记版本、能回滚。开源免费（MIT 协议），全部功能不收费。数据在自己手里，没人能封。 + +--- + +## 二、部署（Docker，一条命令） + +> 注意：NewAPI 已占用 3000 端口，Gitea 改走 **3001**。 + +SSH 上服务器（`ssh ubuntu@43.156.118.130`，再 `sudo -i`），跑： + +```bash +mkdir -p /opt/gitea +docker run -d \ + --name gitea \ + -p 127.0.0.1:3001:3000 \ + -v /opt/gitea:/data \ + --restart unless-stopped \ + gitea/gitea:latest +``` + +检查： + +```bash +docker ps --filter 'name=gitea' --format '{{.Status}} {{.Ports}}' +``` + +看到 `Up` 和 `127.0.0.1:3001->3000` 即成功。 + +**现状**：容器名 `gitea`，数据卷 `/opt/gitea`，数据库 SQLite（默认），开机自启，管理员账号 `admin`。 + +--- + +## 三、访问方式：SSH 隧道 + +Gitea 只绑了 `127.0.0.1`，必须走隧道访问，浏览器开 `http://localhost:3001`。 + +`tunnel.bat`（位于 `F:\AI\docker\cpa-deploy\tunnel.bat`）已加入 3001 转发，现有 7 个端口： + +| 端口 | 用途 | +| --- | --- | +| 8317 | CPA 主 API + 管理面板 | +| 8085 / 1455 / 54545 / 51121 / 11451 | Google OAuth 授权回调端口 | +| **3001** | **Gitea** | + +双击 tunnel.bat，保持窗口开着。单独开隧道时用： + +```powershell +ssh -N -L 3001:127.0.0.1:3001 ubuntu@43.156.118.130 +``` + +--- + +## 四、初始化（只做一次） + +浏览器开 `http://localhost:3001`，安装页保持默认（数据库 SQLite3），往下翻到**管理员账号**，填用户名、密码、邮箱，点**安装 Gitea**，跳转到登录页即完成。 + +--- + +## 五、推代码：第一次踩过的两个坑 + +### 坑 1：Git 没设用户名，提交失败 + +现象：`git commit` 后提示 `nothing added to commit but untracked files present`，随后 `git push` 报 `error: src refspec main does not match any`。 + +原因：新电脑 Git 没配身份，提交被拦，根本没产生提交。 + +解决（先设身份再提交）： + +```powershell +git config --global user.name "admin" +git config --global user.email "beyond1008@gmail.com" +git add . +git commit -m "first commit" +``` + +### 坑 2：本地分支不叫 main + +现象：`git push -u origin main` 报 `error: src refspec main does not match any`（提交已成功时）。 + +原因：本地默认分支是 `master`，不是 `main`。 + +解决（改名再推）： + +```powershell +git branch -M main +git push -u origin main +``` + +### 正常推送流程（以后每次） + +```powershell +git add . +git commit -m "改了什么" +git push +``` + +**现有仓库**：`test`（F:\AI\docker 首次推送）、`Obsidian`（笔记库）。 + +--- + +## 六、Obsidian 自动备份（Obsidian Git 插件） + +### 1. 建仓库 + +Gitea 里点右上角 `+` → 新建仓库，名 `Obsidian`。 + +### 2. 装插件 + +Obsidian → 设置（左下角齿轮）→ 第三方插件 → 关掉**安全模式** → 浏览 → 搜 `Vinzent` → 点 **Git**（作者 Vinzent，3.4M 下载）→ 安装 → 启用。 + +### 3. 笔记库初始化并推送 + +笔记库位置：`F:\AI\Obsidian`。在 PowerShell 里跑（隧道保持开着）： + +```powershell +cd F:\AI\Obsidian +git init +git add . +git commit -m "first commit" +git remote add origin http://localhost:3001/admin/Obsidian.git +git branch -M main +git push -u origin main +``` + +推时填 admin 和 Gitea 密码。 + +### 4. 开自动备份 + +关掉 Obsidian 再重开 → 设置 → 第三方插件 → Git： + +- **Automatic** → **Auto commit-and-sync interval (minutes)** 由 `0` 改成 `10`（0 = 关闭） +- **Sync** 里确认 **Push on commit-and-sync** 和 **Pull on commit-and-sync** 都是开着的 + +此后每 10 分钟自动提交并推送，写笔记不用管。 + +> 注意：自动推送走 `localhost:3001`，隧道必须开着。隧道关了推不上去，下次开隧道后会自动补推。 + +--- + +## 七、另一台电脑怎么下载笔记 + +1. 装 Git（git-scm.com）。 +2. 开隧道（新建 `gitea-tunnel.bat`，双击运行，窗口保持开着）： + ```bat + @echo off + ssh -N -L 3001:127.0.0.1:3001 ubuntu@43.156.118.130 + pause + ``` +3. 克隆（进想放笔记的文件夹）： + ```powershell + git clone http://localhost:3001/admin/Obsidian.git + ``` + 填 admin 和 Gitea 密码。 +4. Obsidian 里点"打开文件夹作为仓库"，选克隆下来的文件夹。 +5. 同样装 Obsidian Git 插件、开 Auto commit-and-sync，即可双向自动备份。 + +--- + +## 八、服务器上现在跑的东西（2026-11-05） + +| 服务 | 位置/端口 | 状态 | +| --- | --- | --- | +| Xray + Shadowsocks（梯子） | 8388，systemd 服务 `xray-ss` | 正常 | +| CPA（Gemini Pro 转 API） | Docker，127.0.0.1:8317 | 正常 | +| NewAPI | Docker，127.0.0.1:3000 | 正常 | +| Nginx | 域名 api.trivoo.website | 正常 | +| **Gitea** | **Docker，127.0.0.1:3001** | **正常** | +| 3x-ui | 已停用（`systemctl stop x-ui`），但仍开机自启 | 待处理：`sudo systemctl disable x-ui` | diff --git a/工具相关/www.md b/工具相关/www.md deleted file mode 100644 index c3879d6..0000000 --- a/工具相关/www.md +++ /dev/null @@ -1,320 +0,0 @@ -# New API 专属大模型网关搭建与 HTTPS 上线全流程实战指南 - -> **实战环境记录** -> - **云服务器**：腾讯云新加坡轻量应用服务器（Ubuntu 24.04 LTS，2核 2G 内存，公网 IP：`43.156.118.130`） -> - **共存服务**：Xray Shadowsocks 代理服务（端口 `8388`，全程独立运行，互不干扰） -> - **域名提供商**：Spaceship（根域名：`trivoo.website`，网关二级子域名：`api.trivoo.website`） -> - **网关核心**：New API（官方镜像 `calciumion/new-api:latest`，Docker 容器化 + 内置 SQLite 持久化） -> - **反代与加密**：Nginx 反向代理 + Let's Encrypt 权威 SSL 证书（Certbot 自动化定时续期） - ---- - -## 目录 -- [一、全局架构与准备工作](#一全局架构与准备工作) -- [二、第一阶段：域名注册与 DNS 解析配置](#二第一阶段域名注册与-dns-解析配置) -- [三、第二阶段：云服务器防火墙安全配置](#三第二阶段云服务器防火墙安全配置) -- [四、第三阶段：New API 容器化部署](#四第三阶段new-api-容器化部署) -- [五、第四阶段：Nginx 反向代理与 SSL 证书自动化](#五第四阶段nginx-反向代理与-ssl-证书自动化) -- [六、第五阶段：New API 初始化与渠道配置](#六第五阶段new-api-初始化与渠道配置) -- [七、第六阶段：客户端接入与高频踩坑排错手册](#七第六阶段客户端接入与高频踩坑排错手册) -- [八、第七阶段：日常运维、安全加固与一键清理](#八第七阶段日常运维安全加固与一键清理) - ---- - -## 一、全局架构与准备工作 - -本方案采用**“单容器 SQLite + Nginx 本地反代 + Certbot 自动化证书”**的生产级架构： - -``` -[ 客户端 (Cline / Cherry Studio / 代码) ] - │ HTTPS (端口 443) - ▼ -[ Nginx 反向代理 (api.trivoo.website) ] ── (自动申请/更新 Let's Encrypt 证书) - │ HTTP (仅监听 127.0.0.1:3000，外部无法直连) - ▼ -[ New API 容器 (calciumion/new-api:latest) ] - │ - ┌─────────┴─────────┐ - ▼ ▼ -[ 官方 DeepSeek API ] [ 自定义第三方聚合上游 ] -``` - -### 核心设计优势： -1. **轻量省资源**：相比 PostgreSQL + Redis 的重型部署，内置 SQLite 单容器仅占几十兆内存，完美兼容 2G 内存低配服务器，与已有代理服务（如 Xray）和谐共存。 -2. **端口安全性**：New API 容器端口严格绑定在 `127.0.0.1:3000`，外部网络无法绕过 HTTPS 直接访问，防止明文直连与未授权嗅探。 -3. **流式传输优化**：Nginx 明确关闭 `proxy_buffering`，保障大模型打字机流式输出（SSE）流畅无卡顿。 - ---- - -## 二、第一阶段：域名注册与 DNS 解析配置 - -### 1. 域名选购（以 Spaceship 为例） -1. 访问 [Spaceship 官网](https://www.spaceship.com/) 并注册/登录账号； -2. 搜索低成本优质后缀（如 `.website`、`.top`、`.xyz` 等，首年特价通常仅约 6~10 元人民币）； -3. 选定域名（本次实战选定 `trivoo.website`，首年仅 7.88 元含 ICANN 认证工本费）； -4. 通过绑定的 **支付宝（Alipay）** 扫码付款完成购买。 -5. **重要防扣费设置**：购买完成后，在域名列表的 `Auto-renew` 列将开关拨至 **Off**，避免次年按原价自动续费。 - -### 2. 添加 DNS A 记录解析 -1. 在 Spaceship 控制台点击域名右侧的 **Advanced DNS ↗**； -2. 点击 **Add Record**（或点击下方小圆圈 `A`）： - - **Type**：`A` - - **Host**：`api`（即二级子域名，完整网址为 `api.trivoo.website`） - - **Value / Target IP**：`43.156.118.130`（你的云服务器公网 IP） - - **TTL**：保持默认或选择 `30 min` / `1 min` -3. 点击 **Add / Save** 保存，等待右侧出现绿色的 `ADDED` 提示。 - ---- - -## 三、第二阶段：云服务器防火墙安全配置 - -登录 [腾讯云轻量服务器控制台](https://console.cloud.tencent.com/lighthouse) -> 点击目标实例 -> **防火墙**，确保以下规则已放行： - -| 应用类型 | 协议 | 端口 | 策略 | 作用说明 | -| :--- | :--- | :--- | :--- | :--- | -| Linux 登录 | TCP | 22 | 允许 | SSH 远程登录维护 | -| HTTP | TCP | 80 | 允许 | Certbot 申请 SSL 证书及 HTTP-01 验证 | -| HTTPS | TCP | 443 | 允许 | 安全加密 Web 访问及客户端 API 调用 | -| 自定义 | TCP | 8388 | 允许 | 已有的 Xray / Shadowsocks 梯子服务 | - -> **安全注意**：不要在公网防火墙中开放 `3000` 端口。生产环境下 3000 端口只走服务器内部回环转发，所有外网流量统一由 443 端口接入。 - ---- - -## 四、第三阶段：New API 容器化部署 - -### 1. 登录服务器并切换 root 权限 -在本地终端执行： -```bash -ssh ubuntu@43.156.118.130 -sudo -i -``` -*(必须通过 `sudo -i` 确保提示符为 `root@...:~#`，避免因普通权限导致 Permission Denied)* - -### 2. 初始化目录并生成专属随机密钥 -```bash -# 创建持久化数据与日志目录 -mkdir -p /opt/new-api/data /opt/new-api/logs -cd /opt/new-api - -# 生成 64 位密码级随机安全会话密钥 -echo "SESSION_SECRET=$(openssl rand -hex 32)" > .env -chmod 600 .env -``` - -### 3. 编写安全生产型 docker-compose.yml -```bash -cat > /opt/new-api/docker-compose.yml <<'EOF' -services: - new-api: - image: calciumion/new-api:latest - container_name: new-api - restart: unless-stopped - command: --log-dir /app/logs - - # 严格绑定回环地址，禁止公网直连 3000 - ports: - - "127.0.0.1:3000:3000" - - volumes: - - ./data:/data - - ./logs:/app/logs - - environment: - - TZ=Asia/Shanghai - - ERROR_LOG_ENABLED=true - - BATCH_UPDATE_ENABLED=true - - NODE_NAME=new-api-sg-1 - - STREAMING_TIMEOUT=300 - - "SESSION_SECRET=${SESSION_SECRET:?未设置 SESSION_SECRET，请检查 .env}" - - SESSION_COOKIE_SECURE=true - - SESSION_COOKIE_TRUSTED_URL=https://api.trivoo.website - - TRUSTED_PROXIES=127.0.0.1,172.17.0.0/16 - - # 内存保护上限（防止高并发下拖垮同机代理服务） - mem_limit: 800m -EOF -``` - -### 4. 启动容器与状态检查 -```bash -cd /opt/new-api -docker compose up -d -docker ps -``` -回显中显示 `new-api` 状态为 `Up` 且端口为 `127.0.0.1:3000->3000/tcp` 即代表容器启动成功。 - ---- - -## 五、第四阶段：Nginx 反向代理与 SSL 证书自动化 - -### 1. 安装 Nginx 与 Certbot 证书套件 -```bash -apt update && apt install -y nginx certbot python3-certbot-nginx -``` - -### 2. 写入 Nginx 站点配置 -创建反向代理配置文件 `/etc/nginx/sites-available/api.trivoo.website`： -```bash -cat > /etc/nginx/sites-available/api.trivoo.website <<'EOF' -map $http_upgrade $connection_upgrade { - default upgrade; - '' close; -} - -server { - listen 80; - server_name api.trivoo.website; - - # 允许大文件上传（如语音转录、多模态图片） - client_max_body_size 100m; - - location / { - proxy_pass http://127.0.0.1:3000; - proxy_http_version 1.1; - - proxy_set_header Host $host; - proxy_set_header X-Real-IP $remote_addr; - proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; - proxy_set_header X-Forwarded-Proto $scheme; - - # WebSocket 协议支持（Realtime / Responses 升级通道） - proxy_set_header Upgrade $http_upgrade; - proxy_set_header Connection $connection_upgrade; - - # 核心：关闭缓冲以支持打字机流式响应（SSE） - proxy_buffering off; - proxy_cache off; - proxy_read_timeout 1800s; - proxy_send_timeout 1800s; - } -} -EOF -``` - -### 3. 启用站点并检查语法 -```bash -ln -sf /etc/nginx/sites-available/api.trivoo.website /etc/nginx/sites-enabled/ -nginx -t && systemctl reload nginx -``` -*(必须看到 `syntax is ok` 与 `test is successful`)* - -### 4. 一键自动签发 Let's Encrypt 证书并启用 HTTPS -```bash -certbot --nginx -d api.trivoo.website --non-interactive --agree-tos -m admin@trivoo.website --redirect -``` -执行完毕后出现： -`Congratulations! You have successfully enabled HTTPS on https://api.trivoo.website` -此时证书已自动安装，并已创建 systemd 自动续期定时器。 - ---- - -## 六、第五阶段：New API 初始化与渠道配置 - -### 1. 首次访问与系统向导 -浏览器访问：`https://api.trivoo.website` -1. **数据库检查**：自动检测出 SQLite，直接点击「下一步」； -2. **管理员账户**：设定管理员用户名和高强度密码； -3. **完成初始化**：进入控制台主界面。 - -### 2. 接入官方渠道（以 DeepSeek 官方为例） -1. 左侧菜单栏点击 **「渠道」** -> 右上角 **「创建渠道」**； -2. **类型**：选择 `DeepSeek`； -3. **API 密钥**：填入 DeepSeek 官方以 `sk-` 开头的 API Key； -4. **模型**：点击快捷操作中的 **「填入相关模型」**，框内自动出现 `deepseek-chat` 与 `deepseek-reasoner` 标签； -5. 点击最底部 **「提交」**； -6. 在渠道列表中点击该卡片右上角的 **仪表盘图标（测速）**，出现绿色延迟（如 `554ms`）代表渠道通信成功。 - -### 3. 接入第三方自定义渠道（以 `apikey.fan` 聚合服务为例） -1. 点击 **「创建渠道」** -> 类型选 **`高级自定义`**（或 OpenAI 兼容）； -2. **API 地址**：填入服务商的基础网关地址（如 `https://api.apikey.fan`）； -3. **API 密钥**：填入该服务商提供的密钥； -4. **模型**：手动输入该上游支持的具体模型名（如 `gpt-5.6-terra`），**按回车确认生成标签**； -5. 点击提交并点击测试图标，验证连通性。 - -### 4. 生成调用令牌（分发密钥） -1. 左侧菜单栏点击 **「常规」 -> 「API 密钥」**（或「令牌」）； -2. 点击右上角 **「创建密钥」**； -3. 设定名称（如 `default-token`），额度设为无限或指定额度； -4. 提交后在列表中点击 **「复制」**，获取专属于该网关的 `sk-xxxx` 令牌。 - ---- - -## 七、第六阶段：客户端接入与高频踩坑排错手册 - -### 1. 客户端标准配置示例 - -在任何支持第三方 API 的客户端（如 Cline、NextChat、Cherry Studio、Chatbox 等）中配置： - -- **接口地址 / Base URL**：`https://api.trivoo.website/v1` -- **API Key**：填入后台生成的 `sk-xxxx` 令牌 -- **模型名称**：填入渠道中已有的有效模型（如 `deepseek-chat` 或 `gpt-5.6-terra`） - ---- - -### 2. 实战高频报错与精准排错对照 - -#### ❌ 错误 1：`404 Invalid URL (POST /v1/v1/messages)` -* **现象**：客户端报错 404，请求路径出现重复的 `/v1/v1`。 -* **原因**：部分遵循 Anthropic / Claude 协议的客户端（如某些版本的 Cline），内部会自动为地址补全 `/v1/messages`。如果你在配置的 Base URL 中包含了 `/v1`，拼接后就会变成 `/v1/v1/messages`。 -* **解决方案**：将客户端的 API 地址末尾的 `/v1` 删掉，改为 `https://api.trivoo.website`。 - -#### ❌ 错误 2：`503 No available channel for model xxx under group default` -* **现象**：客户端发起调用，返回 `model_not_found`。 -* **原因**：客户端发送的模型请求名称（例如 `gpt-5.6-terra`），在 New API 的所有可用渠道模型列表中都不存在。 -* **解决方案**： - - **方案 A（改客户端）**：将客户端的模型名称改为渠道真实支持的名字（如 `deepseek-chat`）； - - **方案 B（改网关重定向）**：在 New API 对应渠道编辑页中，点击「设置模型重定向」，将外部请求的 `gpt-5.6-terra` 重定向映射到后端的 `deepseek-chat`。 - -#### ❌ 错误 3：`Permission denied` / `No such file or directory` -* **现象**：在服务器终端执行 Docker 或 Nginx 配置命令时报错。 -* **原因**：新开的 SSH 会话默认处于普通用户 `ubuntu` 权限。 -* **解决方案**：执行命令前务必先输入 `sudo -i` 切换到 `root` 账户。 - -#### ❌ 错误 4：Spaceship 登录报 `Invalid username or password` -* **现象**：明明输入了正确邮箱和密码，却无法登录 Spaceship。 -* **原因**：Spaceship 强制要求在第一栏输入当初注册时设置的 **Username（用户名，如 `Beyond`）**，不支持直接使用邮箱登录。 -* **解决方案**：在注册邮件中查找用户名，使用纯用户名登录。 - ---- - -## 八、第七阶段：日常运维、安全加固与一键清理 - -### 1. 生产环境安全加固（必做） -* **关闭公开注册**： - 进入后台 `https://api.trivoo.website` -> **「系统设置」 -> 「登录注册」** -> 将 **「允许新用户注册」彻底关闭**。 - *(防止域名暴露在公网后被爬虫扫描并注册账号白嫖接口额度)* -* **SSL 自动续期确认**： - Certbot 已经注册了 systemd 定时任务，可通过以下命令测试自动续期机制： - ```bash - certbot renew --dry-run - ``` - -### 2. 日常启停与重启 -```bash -# 暂停 New API 网关（保留所有数据，释放 CPU/内存占用） -cd /opt/new-api && docker compose stop && systemctl stop nginx - -# 重新启动 New API 网关 -cd /opt/new-api && docker compose start && systemctl start nginx - -# 查看实时运行日志 -cd /opt/new-api && docker compose logs -f --tail=100 new-api -``` - -### 3. 一键卸载与彻底清理（恢复纯净服务器） -如果后续需要腾空服务器，执行以下步骤可在 1 分钟内完全清理痕迹，且**完全不影响服务器原有的代理与 SSH 服务**： - -```bash -# 1. 停止并销毁容器及持久化目录 -cd /opt/new-api && docker compose down -rm -rf /opt/new-api - -# 2. 卸载 Nginx 站点配置 -rm -f /etc/nginx/sites-enabled/api.trivoo.website /etc/nginx/sites-available/api.trivoo.website -systemctl reload nginx - -# 3. 删除 Let's Encrypt 证书记录（可选） -certbot delete --cert-name api.trivoo.website -``` -同时登录 Spaceship 域名控制台，将 `api.trivoo.website` 的 A 记录直接点击删除即可。