cdrop — 跨 OS 剪贴板与文件传输服务

Commilitia Drop：自托管的跨设备剪贴板同步与点对点文件传输。 - 后端 Go（chi / SQLite WAL / SSE Hub / WebRTC signaling + 状态机 / Relay ring buffer），编译进单个 distroless 镜像（前端 go:embed）。 - 前端 React + TanStack Router + Zustand，自实现 SSE + WebRTC P2P，NAT 受阻时回退服务端中继；聚珍（Juzhen）CJK 综合排版。 - 桌面端 Wails v2（macOS / Windows），瘦客户端复用 web。 - 鉴权 OIDC PKCE（自建 Casdoor 等），refresh_token 信封加密存系统密钥库；iOS Shortcut 用 HS256 scoped token。架构文档与变更记录见 docs 分支（PROJECT_BRIEF / FRONTEND_DESIGN / CHANGELOG）。本次为公开发布初始提交：完整开发历史（含部署细节）留存于私有归档，公开仓库自此干净起步。
2026-06-15 21:38:28 +08:00
commit f21fa5b5e8
239 changed files with 29010 additions and 0 deletions
@@ -0,0 +1,38 @@
+# cdrop 在你的 docker-compose.yaml 中的服务条目片段。
+# NN 由你决定（与既有服务区分的编号 / 名称）；your-proxy-network 换成你的反代所在网络。
+#
+# 不显式 ports —— 走内部网络，反代（如 Caddy）通过 NN-cdrop:8080 访问。
+# 持久化挂一个目录到 /data，里面只有 cdrop.db（SQLite WAL）。
+
+NN-cdrop:
+    image: cdrop:latest
+    container_name: NN-cdrop
+    restart: unless-stopped
+    networks: [your-proxy-network]
+    ports: []
+    volumes:
+        - ./NN-cdrop/data:/data
+    environment:
+        # M13 首轮 dev 模式（验证 Caddy / H3 管道），稳定后切 prod 见下方注释
+        CDROP_AUTH_MODE: dev
+        CDROP_DEV_TOKEN: REPLACE_WITH_RANDOM_HEX64
+        CDROP_DB_PATH: /data/cdrop.db
+        CDROP_LISTEN: ":8080"
+        CDROP_DEVICE_TTL_HOURS: "196"
+
+        # ---- prod 切换时启用以下，并把 CDROP_AUTH_MODE 改成 prod、删掉 DEV_TOKEN ----
+        # CDROP_OIDC_AUTHORIZE_URL: https://your-idp.example/login/oauth/authorize
+        # CDROP_OIDC_TOKEN_URL:     https://your-idp.example/api/login/oauth/access_token
+        # JWKS 可走 IdP 内网地址省一跳；也可用公网 https。
+        # CDROP_OIDC_JWKS_URL:      https://your-idp.example/.well-known/jwks
+        # CDROP_OIDC_ISSUER:        https://your-idp.example/
+        # prod 强制非空（空则跳过 audience 校验 = 同 JWKS 其他应用可冒充）
+        # CDROP_OIDC_AUDIENCE:      <你的 OAuth client_id>
+        # CDROP_OIDC_CLIENT_ID:     <你的 OAuth client_id>
+        # CDROP_OIDC_REDIRECT_URI:  https://your-domain.example/oauth/callback
+        # CDROP_OIDC_SCOPES:        "openid profile email"
+        # CDROP_HS256_SECRET:       REPLACE_WITH_RANDOM_HEX64
+
+        # ---- 可选：Cloudflare Realtime TURN over TLS（不配则前端 STUN-only 兜底）----
+        # CDROP_CF_TURN_KEY_ID:     <dash.cloudflare.com → Realtime → TURN App>
+        # CDROP_CF_TURN_API_TOKEN:  <同 App 派发的 API Token>