feat: expose BookOrbit through HK edge

2026-09-27 22:05:43 -07:00
parent 2d45a6dfe2
commit f2921fa9f6
10 changed files with 124 additions and 2 deletions
@@ -0,0 +1,10 @@
+# BookOrbit HK 公网边缘
+
+该项目运行 FRP 服务端，接收 `media-core` 主动建立的加密隧道。BookOrbit 只映射到容器网络 `hk-web` 的 `bookorbit-frps:13000`，不直接发布该业务端口；Caddy 负责 `https://books.kais.cloud` 的 TLS 和反向代理。
+
+- 公网隧道控制端口：TCP `7000`
+- 内部 BookOrbit 端口：TCP `13000`，仅 `hk-web` 可见
+- 密钥：Arcane Project Environment 中的 `FRP_TOKEN`，不得写入 Git
+- 镜像：FRP `0.71.0`，固定 OCI index digest
+
+`FRP_TOKEN` 必须和 `servers/media-core/bookorbit-edge` 项目一致。该项目不启用 FRP Dashboard，也不允许客户端申请 `13000` 以外的远端端口。
@@ -0,0 +1,35 @@
+x-arcane:
+  icon: book-open
+  urls:
+    - https://books.kais.cloud/
+
+services:
+  frps:
+    image: ghcr.io/fatedier/frps:v0.71.0@sha256:cd8b947ba61678b200baa4f71ccc33f3c52e4e2cc0059700ba3b8354e36af7c3
+    container_name: bookorbit-frps
+    restart: unless-stopped
+    command: ["-c", "/etc/frp/frps.toml"]
+    environment:
+      FRP_TOKEN: ${FRP_TOKEN}
+    ports:
+      - "7000:7000"
+    volumes:
+      - ./frps.toml:/etc/frp/frps.toml:ro
+    networks:
+      - hk-web
+    security_opt:
+      - no-new-privileges:true
+    cap_drop:
+      - ALL
+    labels:
+      com.getarcaneapp.arcane.icon: book-open
+    logging:
+      driver: json-file
+      options:
+        max-size: 2m
+        max-file: "3"
+
+networks:
+  hk-web:
+    external: true
+    name: hk-web
@@ -0,0 +1,11 @@
+bindAddr = "0.0.0.0"
+bindPort = 7000
+
+auth.method = "token"
+auth.token = "{{ .Envs.FRP_TOKEN }}"
+
+transport.tls.force = true
+
+allowPorts = [
+  { start = 13000, end = 13000 }
+]