sync huggingface deployment from Viciy2023/CLIProxyAPI@757f412a36d42bcd769c7008d4edf8ab528ada99

.env

@@ -0,0 +1,63 @@
+# Hugging Face Space 部署模式。
+# 必须保留为 cloud，用于启用项目的云部署启动逻辑。
+DEPLOY=cloud
+
+# 管理接口密码。
+# 必须设置为你自己的强密码，否则远程管理接口不可安全使用。
+MANAGEMENT_PASSWORD=change-this-to-a-strong-random-password
+
+# 管理面板静态资源目录。
+# 默认不需要设置，只有你要手动指定管理面板静态文件目录时才启用。
+# MANAGEMENT_STATIC_PATH=
+
+# PostgreSQL 存储连接串。
+# 默认文件存储部署不需要设置，只有切换到 PostgreSQL 存储时才启用。
+# PGSTORE_DSN=postgresql://user:password@host:5432/cliproxyapi
+
+# PostgreSQL 使用的 schema。
+# 默认文件存储部署不需要设置，只有切换到 PostgreSQL 存储时才启用。
+# PGSTORE_SCHEMA=public
+
+# PostgreSQL 本地缓冲目录。
+# 默认文件存储部署不需要设置，只有切换到 PostgreSQL 存储时才启用。
+# PGSTORE_LOCAL_PATH=/data
+
+# Git 存储仓库地址。
+# 默认文件存储部署不需要设置，只有切换到 Git 存储时才启用。
+# GITSTORE_GIT_URL=https://github.com/your-org/cli-proxy-config.git
+
+# Git 存储仓库用户名。
+# 默认文件存储部署不需要设置，只有切换到 Git 存储时才启用。
+# GITSTORE_GIT_USERNAME=git-user
+
+# Git 存储仓库访问令牌。
+# 默认文件存储部署不需要设置，只有切换到 Git 存储时才启用。
+# GITSTORE_GIT_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
+
+# Git 存储使用的分支名。
+# 默认文件存储部署不需要设置，只有切换到 Git 存储时才启用。
+# GITSTORE_GIT_BRANCH=main
+
+# Git 存储本地工作目录。
+# 默认文件存储部署不需要设置，只有切换到 Git 存储时才启用。
+# GITSTORE_LOCAL_PATH=/data
+
+# 对象存储服务地址。
+# 默认文件存储部署不需要设置，只有切换到对象存储时才启用。
+# OBJECTSTORE_ENDPOINT=https://s3.your-cloud.example.com
+
+# 对象存储访问密钥 ID。
+# 默认文件存储部署不需要设置，只有切换到对象存储时才启用。
+# OBJECTSTORE_ACCESS_KEY=your-access-key
+
+# 对象存储访问密钥 Secret。
+# 默认文件存储部署不需要设置，只有切换到对象存储时才启用。
+# OBJECTSTORE_SECRET_KEY=your-secret-key
+
+# 对象存储桶名称。
+# 默认文件存储部署不需要设置，只有切换到对象存储时才启用。
+# OBJECTSTORE_BUCKET=cli-proxy-config
+
+# 对象存储本地缓存目录。
+# 默认文件存储部署不需要设置，只有切换到对象存储时才启用。
+# OBJECTSTORE_LOCAL_PATH=/data

.gitattributes

@@ -1,35 +0,0 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
-*.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tar filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz filter=lfs diff=lfs merge=lfs -text
-*.zip filter=lfs diff=lfs merge=lfs -text
-*.zst filter=lfs diff=lfs merge=lfs -text
-*tfevents* filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,3 @@
+.DS_Store
+*.log
+tmp/

Dockerfile

@@ -0,0 +1,42 @@
+FROM alpine:3.22.0
+
+ARG CLIPROXYAPI_REPO=router-for-me/CLIProxyAPI
+
+ENV APP_HOME=/opt/cli-proxy-api \
+    DATA_DIR=/data \
+    HOME=/data \
+    TZ=Asia/Shanghai
+
+RUN apk add --no-cache ca-certificates curl tar tzdata
+
+RUN mkdir -p "$APP_HOME" "$DATA_DIR"
+
+RUN set -eux; \
+    latest_url="$(curl -fsSLI -o /dev/null -w '%{url_effective}' "https://github.com/${CLIPROXYAPI_REPO}/releases/latest")"; \
+    tag="${latest_url##*/}"; \
+    version="${tag#v}"; \
+    asset="CLIProxyAPI_${version}_linux_amd64.tar.gz"; \
+    asset_url="https://github.com/${CLIPROXYAPI_REPO}/releases/download/${tag}/${asset}"; \
+    checksums_url="https://github.com/${CLIPROXYAPI_REPO}/releases/download/${tag}/checksums.txt"; \
+    curl -fsSL "$checksums_url" -o /tmp/checksums.txt; \
+    curl -fsSL "$asset_url" -o /tmp/cli-proxy-api.tar.gz; \
+    expected_sha="$(grep " ${asset}$" /tmp/checksums.txt | awk '{print $1}')"; \
+    test -n "$expected_sha"; \
+    echo "$expected_sha  /tmp/cli-proxy-api.tar.gz" | sha256sum -c -; \
+    tar -xzf /tmp/cli-proxy-api.tar.gz -C "$APP_HOME"; \
+    if [ -f "$APP_HOME/CLIProxyAPI" ]; then mv "$APP_HOME/CLIProxyAPI" "$APP_HOME/cli-proxy-api"; fi; \
+    test -f "$APP_HOME/cli-proxy-api"; \
+    chmod +x "$APP_HOME/cli-proxy-api"; \
+    rm -f /tmp/checksums.txt /tmp/cli-proxy-api.tar.gz
+
+COPY entrypoint.sh /entrypoint.sh
+
+RUN chmod +x /entrypoint.sh && \
+    cp /usr/share/zoneinfo/${TZ} /etc/localtime && \
+    echo "${TZ}" > /etc/timezone
+
+WORKDIR /data
+
+EXPOSE 8317
+
+ENTRYPOINT ["/entrypoint.sh"]

README.md

@@ -1,10 +1,29 @@
 ---
-title: CliProxyApiServer
-emoji: 🏆
-colorFrom: red
-colorTo: yellow
+title: CLIProxyAPI Server
 sdk: docker
+app_port: 8317
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# CLIProxyAPI Server
+
+This Space runs `CLIProxyAPI` from the latest upstream GitHub release instead of building from source.
+
+## Runtime Layout
+
+- Persistent data directory: `/data`
+- Environment file: `/data/.env`
+- Main config file: `/data/config.yaml`
+- Default home directory: `/data`
+
+## Startup Behavior
+
+- The container downloads the latest release from `router-for-me/CLIProxyAPI` during image build.
+- On first start, if `/data/config.yaml` does not exist, it is created from the bundled `config.example.yaml`.
+- The service starts with `--config /data/config.yaml`.
+- Because the working directory is `/data`, CLIProxyAPI loads `/data/.env` automatically.
+
+## Notes
+
+- Keep the service port aligned with this Space setting. The default here is `8317`.
+- Persisted auth data and other runtime files stay under `/data`.

config.yaml

@@ -0,0 +1,72 @@
+# Hugging Face Space 推荐最小配置模板。
+# 容器启动时会优先读取 /data/config.yaml。
+# 如果 /data/config.yaml 不存在，可先将本文件内容作为初始配置使用。
+
+# 监听所有网卡，便于 Hugging Face 外部访问。
+host: ""
+
+# 服务端口，需要和 Space 的 app_port 保持一致。
+port: 8317
+
+remote-management:
+  # 允许从外部访问管理接口，否则 Hugging Face 域名无法打开管理功能。
+  allow-remote: true
+
+  # 管理密钥。
+  # 建议与 /data/.env 里的 MANAGEMENT_PASSWORD 使用同一个强密码，便于统一管理。
+  secret-key: "change-this-to-a-strong-random-password"
+
+  # 保持默认即可。首次访问管理面板时会自动获取管理面板资源。
+  disable-control-panel: false
+
+  # 管理面板资源仓库，保持默认即可。
+  panel-github-repository: "https://github.com/router-for-me/Cli-Proxy-API-Management-Center"
+
+# 客户端调用本代理服务时使用的访问密钥。
+# 至少保留一个，并替换为你自己的值。
+api-keys:
+  - "change-this-to-your-client-api-key"
+
+# 认证数据默认落在 /data 下，配合挂载存储可持久化。
+auth-dir: "/data/.cli-proxy-api"
+
+# 初期建议关闭调试日志，稳定后再按需打开。
+debug: false
+
+# 默认为关闭，避免额外暴露调试端口。
+pprof:
+  enable: false
+  addr: "127.0.0.1:8316"
+
+# 默认关闭，避免无配置时暴露 websocket 接口。
+ws-auth: false
+
+# 使用默认轮询策略即可。
+routing:
+  strategy: "round-robin"
+  session-affinity: false
+  session-affinity-ttl: "1h"
+
+# 下面按需启用至少一种上游能力，否则服务虽然能启动，但无法真正转发模型请求。
+
+# 方式一：Gemini API Key
+# gemini-api-key:
+#   - api-key: "AIzaSy..."
+
+# 方式二：Codex API Key
+# codex-api-key:
+#   - api-key: "sk-..."
+
+# 方式三：Claude API Key
+# claude-api-key:
+#   - api-key: "sk-ant-..."
+
+# 方式四：OpenAI 兼容上游
+# openai-compatibility:
+#   - name: "openrouter"
+#     base-url: "https://openrouter.ai/api/v1"
+#     api-key-entries:
+#       - api-key: "sk-or-v1-..."
+#     models:
+#       - name: "moonshotai/kimi-k2:free"
+#         alias: "kimi-k2"

entrypoint.sh

@@ -0,0 +1,30 @@
+#!/bin/sh
+set -eu
+
+APP_HOME="${APP_HOME:-/opt/cli-proxy-api}"
+DATA_DIR="${DATA_DIR:-/data}"
+CONFIG_PATH="${CONFIG_PATH:-${DATA_DIR}/config.yaml}"
+EXAMPLE_PATH="${APP_HOME}/config.example.yaml"
+
+mkdir -p "${DATA_DIR}" "${DATA_DIR}/auths" "${DATA_DIR}/logs" "${DATA_DIR}/.cli-proxy-api"
+
+export HOME="${DATA_DIR}"
+export DEPLOY="${DEPLOY:-cloud}"
+
+cd "${DATA_DIR}"
+
+if [ ! -f "${DATA_DIR}/.env" ]; then
+  printf '%s\n' "warning: ${DATA_DIR}/.env not found, starting without extra environment variables" >&2
+fi
+
+if [ ! -f "${CONFIG_PATH}" ]; then
+  if [ ! -f "${EXAMPLE_PATH}" ]; then
+    printf '%s\n' "fatal: bundled config.example.yaml not found at ${EXAMPLE_PATH}" >&2
+    exit 1
+  fi
+
+  cp "${EXAMPLE_PATH}" "${CONFIG_PATH}"
+  printf '%s\n' "initialized ${CONFIG_PATH} from bundled config.example.yaml"
+fi
+
+exec "${APP_HOME}/cli-proxy-api" --config "${CONFIG_PATH}"