安装 COGO

COGO 是一个容器（或一个二进制文件）。唯二重要的两件事：在 /vault 挂载一个卷让你的笔记在更新后存活，以及——在服务器上——设置一个令牌。

在服务器上，COGO 没有令牌就拒绝启动（这样就没人能径直走进你的保险库）。生成一个足够长的令牌并保管好——我们称它为 YOUR-TOKEN：

openssl rand -hex 32

COGO_ALLOW_INSECURE=1 只为本地、仅环回的运行而存在——绝不要在服务器上使用它。

在你的机器上（本地，2 分钟）

安装好 Docker Desktop 后：

docker run -d --name cogo -p 127.0.0.1:8095:8080 \
  -v cogo-vault:/vault -e COGO_ALLOW_INSECURE=1 \
  ghcr.io/diegoparras/cogo

打开 **http://localhost:8095**。搞定——你会看到按置信度着色的保险库，可以在浏览器中捕获和编辑笔记。

-p 127.0.0.1:8095:8080 只在你的机器上发布它——你网络中的其他人看不到它。
-v cogo-vault:/vault 将你的笔记保存在一个卷中，使它们不会被删除。
-e COGO_ALLOW_INSECURE=1 的意思是「我知道这是本地，别向我要令牌」。仅限本地。

不用 Docker——一个静态二进制文件，无需运行时：

cogo serve -http 127.0.0.1:8080 -vault ./vault

在服务器上使用 EasyPanel（推荐）

EasyPanel 与 docker-compose 处不来——不要使用「Compose」类型。请使用 App 类型，它更简单，而且会自行添加 HTTPS。

在你的 EasyPanel 项目中，+ Add Service → App，命名为 cogo。
Source——要么选 GitHub（仓库 diegoparras/cogo、分支 main、Build = Dockerfile；始终有效），要么选 Docker Image ghcr.io/diegoparras/cogo:latest（要求该包是公开的）。
Environment：
```
COGO_MCP_TOKEN=YOUR-TOKEN
COOKIE_SECURE=1
```
（COGO_VAULT=/vault 已经是默认值。）
Mounts → Add Mount——类型 Volume，名称 cogo-vault，挂载路径 /vault。跳过这一步的话，每次更新都会抹掉你的笔记。
Domains → Add Domain——你的域名，端口 8080（COGO 的内部端口）。 HTTPS 证书由 EasyPanel 自行签发。若被询问健康检查路径：/healthz。
Deploy，打开你的域名，并在查看器询问时粘贴 YOUR-TOKEN。

如果应用在启动时崩溃，那是你忘了 COGO_MCP_TOKEN——COGO 有意拒绝毫无防护地坐在互联网上。

在 VPS 上手动部署

最安全的形态（银行级）：完全不暴露端口——将它绑定到环回地址，并通过隧道访问。

# on the VPS:
docker run -d --name cogo -p 127.0.0.1:8080:8080 \
  -v cogo-vault:/vault -e COGO_MCP_TOKEN=YOUR-TOKEN \
  ghcr.io/diegoparras/cogo

# on your machine (SSH tunnel):
ssh -N -L 8080:127.0.0.1:8080 user@your-vps

打开 http://localhost:8080。加固部署的细节（隧道／VPN、经代理的 TLS、各种限制）位于 docs/seguridad.md。

连接 Claude Code（MCP）

本地——最简单：不走网络，每个会话启动自己的 COGO。在 .mcp.json 中：

{ "mcpServers": { "cogo": { "command": "cogo", "args": ["serve", "-vault", "./vault"] } } }

远程——通过 HTTP，令牌放在请求头中：

{
  "mcpServers": {
    "cogo": {
      "type": "http",
      "url": "https://your-domain/mcp",
      "headers": { "Authorization": "Bearer YOUR-TOKEN" }
    }
  }
}

从此，在任何会话中你都可以请求 pack "<topic>" 获得着色的上下文，或用 capture 捕获一个发现。Claude 今天学到的，Cursor 明天就能读到：同一个保险库。

更新

EasyPanel：再次点击 Deploy（或 Rebuild）。得益于 /vault 卷，你的笔记会保留。
普通 Docker：docker pull ghcr.io/diegoparras/cogo，然后用相同的 -v cogo-vault:/vault 重建容器。

可选：AI 模型

COGO 没有模型也运转良好。如果你希望它检测笔记之间的矛盾并磨利 Guard，打开查看器 → 菜单 → 设置 · AI 模型，连接一个本地（Ollama）或远程（OpenRouter、DeepSeek）模型。Token 花费显示在同一个菜单中。

阅读文档