# Hugging Face Spaces 推荐运行配置 # 说明:这个文件是示例模板,不要把真实密钥直接写进仓库 # # 使用方式: # 1. GitHub Actions 中配置自动同步所需变量 # - Secret: HF_TOKEN # - Variable: HF_SPACE_ID=DanielleNguyen/Qwen2API-A # 2. Hugging Face Space 中按下面两类分别配置: # - HF Secrets:敏感信息,例如 API_KEY、HF_TOKEN # - HF Variables:普通运行配置,例如端口、目录、开关 # 3. 不建议在仓库中提交真实 .env 文件 # ================================================== # HF Secrets 建议新建这些 # ================================================== # API_KEY=sk-admin-yourkey,sk-user-yourkey # HF_TOKEN=hf_xxx # HF_BUCKET_TOKEN= # ACCOUNTS= # REDIS_URL= # PROXY_URL= # QWEN_CHAT_PROXY_URL= # QWEN_CLI_PROXY_URL= # ================================================== # HF Variables 建议新建这些 # ================================================== # ============================== # 服务监听配置 # Hugging Face Docker Space 建议固定如下: # - SERVICE_PORT=7860 # - LISTEN_ADDRESS=0.0.0.0 # ============================== SERVICE_PORT=7860 LISTEN_ADDRESS=0.0.0.0 # ============================== # 运行模式配置 # Hugging Face 免费空间当前建议单进程运行,更稳定 # PM2_MAX_MEMORY 是自动重启阈值,不是实际只给 4G 内存 # ============================== PM2_INSTANCES=1 PM2_MAX_MEMORY=4G NODE_ENV=production # ============================== # API 访问密钥 # 第一个密钥是管理员密钥,后面的密钥是普通调用密钥 # 这是敏感信息,建议放到 HF Secrets # ============================== API_KEY=sk-admin-demo,sk-user-demo # ============================== # 功能配置 # 这些属于普通配置,建议放到 HF Variables # ============================== OUTPUT_THINK=true SEARCH_INFO_MODE=table SIMPLE_MODEL_MAP=false # ============================== # 数据存储配置 # 当前推荐方案:使用 Hugging Face Bucket 做文件持久化 # - 项目内部使用 DATA_SAVE_MODE=file # - 启动时从 Bucket 拉取数据到本地目录 # - 运行中定时同步本地目录回 Bucket # ============================== DATA_SAVE_MODE=file # 下面两项通常属于敏感信息,建议放到 HF Secrets REDIS_URL= ACCOUNTS= # 下面这些路径配置建议放到 HF Variables DATA_DIR=/data/qwen2api/data CACHE_DIR=/data/qwen2api/caches LOG_DIR=/data/qwen2api/logs # ============================== # Hugging Face Bucket 持久化配置 # HF_BUCKET_REPO:你的 Bucket 名称,建议放到 HF Variables # HF_TOKEN:Hugging Face 账号 Token,Space 通过它访问 Bucket,建议放到 HF Secrets # HF_BUCKET_TOKEN:可选;如果单独给 Bucket 配 token,则优先使用它,也建议放到 HF Secrets # ============================== HF_BUCKET_REPO=DanielleNguyen/Qwen2API-A-Storage HF_TOKEN= HF_BUCKET_TOKEN= HF_BUCKET_LOCAL_DIR=/data/qwen2api HF_BUCKET_REMOTE_DIR=runtime HF_BUCKET_SYNC_INTERVAL=300 HF_BUCKET_SYNC_DEBOUNCE_SECONDS=5 HF_BUCKET_STARTUP_GRACE_SECONDS=30 # ============================== # 日志配置 # Hugging Face 一般不建议开启文件日志,直接看容器日志即可 # ============================== LOG_LEVEL=INFO ENABLE_FILE_LOG=false MAX_LOG_FILE_SIZE=10 MAX_LOG_FILES=5 # ============================== # 代理 / 上游反代配置 # 按需填写;不需要就留空 # 如果地址中带认证信息,建议放到 HF Secrets # ============================== QWEN_CHAT_PROXY_URL= QWEN_CLI_PROXY_URL= PROXY_URL= # ============================== # 图片缓存配置 # 配合 Bucket 持久化时建议使用 file # ============================== CACHE_MODE=file