Fuclaude：5分钟上手的容器化应用框架

项目核心解析：理解关键文件架构

⚙️ 许可证文件：明确使用边界

功能定位：LICENSE文件定义了项目的合法使用范围，采用「MIT许可证」（一种宽松的开源协议）。
关键参数：允许免费使用、修改和分发，但必须保留原始版权声明。
使用场景：商业项目集成、二次开发或开源贡献时需遵守协议条款。

📝 项目说明文件：快速了解项目价值

功能定位：README.md是项目的「名片」，包含核心功能概述。
关键内容：当前版本仅包含项目名称"Fuclaude"及描述"啥也不是"，建议补充功能说明和使用示例。
使用场景：新用户首次接触项目时的快速入门指南。

🔧 配置文件：定制应用行为

功能定位：config.json是应用的「控制面板」，存储运行时参数。
核心配置示例（精简版）：

{
  "bind": "127.0.0.1:8181",  # 关键配置：应用绑定的IP和端口，默认值"127.0.0.1:8181"（仅本地访问）
  "timeout": 600,            # 关键配置：请求超时时间（秒），建议值300-1200
  "cookie_secret": "1234567890abcdefghijklmnopqrstuv",  # 关键配置：Cookie加密密钥，风险提示：生产环境需更换为随机字符串
  "openai_api_key": "sk-xxx" # 关键配置：API密钥，建议值：从OpenAI控制台获取的有效密钥
}

使用场景：调整服务端口、集成第三方API或设置安全参数。

🐳 容器编排文件：一键启动应用

功能定位：docker-compose.yml是应用的「启动脚本」，定义Docker容器配置。
核心配置示例（精简版）：

version: '3'
services:
  fuclaude:
    image: pengzhile/fuclaude  # 关键配置：官方Docker镜像，默认值：pengzhile/fuclaude
    ports:
      - "127.0.0.1:8181:8181"  # 关键配置：端口映射（主机:容器），类比"房间钥匙孔对应"，确保内外端口一致
    environment:
      - TZ=Asia/Shanghai       # 关键配置：时区设置，建议值：Asia/Shanghai（国内用户）
    restart: unless-stopped    # 关键配置：自动重启策略，默认值：容器退出时除非手动停止否则自动重启

使用场景：本地测试、服务器部署或多环境一致性保障。

环境部署指南：3步启动应用

▶️ 步骤1：获取项目代码

通过Git克隆仓库到本地：

git clone https://gitcode.com/gh_mirrors/fu/fuclaude
cd fuclaude

▶️ 步骤2：配置关键参数

1. 打开config.json文件，替换以下参数：
   • openai_api_key：填入有效的OpenAI API密钥
   • cookie_secret：生成随机字符串（建议长度≥32位）
2. 配置生效方法：修改后无需重启容器，下次启动时自动加载新配置。

▶️ 步骤3：启动容器服务

在项目根目录执行Docker Compose命令：

docker-compose up -d

验证服务状态：访问http://127.0.0.1:8181，出现应用界面即部署成功。

配置参数详解：优化应用性能

网络配置

参数名	功能说明	默认值	建议值
bind	服务绑定地址	127.0.0.1:8181	公网部署改为0.0.0.0:8181
timeout	请求超时时间	600秒	长任务（如大文件处理）设为1200秒

安全配置

参数名	功能说明	默认值	风险提示
cookie_secret	Cookie加密密钥	1234567890abcdef...	生产环境必须更换，否则存在安全风险
site_password	访问密码	空值（无密码）	公开服务建议设置8位以上复杂密码

OpenAI集成

参数名	功能说明	默认值	使用场景
openai_base_url	API请求地址	https://api.openai.com/v1	国内用户可配置代理地址
moderation_enabled	内容审核开关	false	公开服务建议开启（设为true）

常见问题

Q：修改配置后如何生效？
A：若容器已运行，执行docker-compose restart重启服务；若未运行，直接docker-compose up -d启动时自动加载新配置。

Q：服务启动后无法访问怎么办？
A：检查bind参数是否设为0.0.0.0:8181（允许外部访问），并确认主机防火墙开放8181端口。

Q：API调用提示密钥无效？
A：验证openai_api_key是否正确，或尝试更换为新生成的密钥（注意去除首尾空格）。