1.环境准备

确保系统已扮装Docker和Docker-compose，若尚未安装，可参考以下步骤操作：

1.1 安装Docker

（1）安装docker。
sudo curl -fsSL https://github.com/tech-shrimp/docker_installer/releases/download/latest/linux.sh| bash -s docker --mirror Aliyun

(2)启动docker。
sudo systemctl start docker

1.2 安装Docker-compose

（1）下载docker-compose文件。
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

(2)赋予docker-compose执行权限。
sudo chmod +x /usr/local/bin/docker-compose

2.克隆项目

将闲鱼机器人项目文件克隆至本机中。
git clone https://github.com/dingyufei615/ai-goofish-monitor cd ai-goofish-monitor

3.机器人配置

3.1 创建配置文件信息

在保存闲鱼机器人项目的目录里，复制.env.example文件并命名为.env。然后编辑.env文件。
cd ai-goofish-monitor
cp .env.example .env
vim .env

3.2 填写配置项

.env文件中的所有可用配置项如下：	环境变量	说明	是否必填
OPENAI_API_KEY	你的AI模型服务商提供的API Key。	是	对于某些本地或特定代理的服务，此项可能为可选。
OPENAI_BASE_URL	AI模型的API接口地址，必须兼容OpenAI格式。	是	请填写API的基础路径，例如 https://ark.cn-beijing.volces.com/api/v3/ 。
OPENAI_MODEL_NAME	你要使用的具体模型名称。	是	必须选择一个支持图片分析的多模态模型，如 doubao-seed-1-6-250615, gemini-2.5-pro 等。
PROXY_URL (可选)	需要翻墙时配置的HTTP/S代理。	否	支持 http:// 和 socks5:// 格式。例如 http://127.0.0.1:7890 。
NTFY_TOPIC_URL (可选)	https://ntfy.sh/ 的主题URL，用于发送通知。	否	如果留空，将不会发送 ntfy 通知。
GOTIFY_URL (可选)	Gotify 服务地址。	否	例如 https://push.example.de 。
GOTIFY_TOKEN (可选)	Gotify 应用的 Token。	否	--
BARK_URL (可选)	https://bark.day.app/ 的推送地址。	否	例如 https://api.day.app/your_key 。如果留空，将不发送 Bark 通知。
WX_BOT_URL (可选)	企业微信群机器人的 Webhook 地址。	否	如果留空，将不会发送企业微信通知。
WEBHOOK_URL (可选)	通用 Webhook 的 URL 地址。	否	如果留空，将不发送通用 Webhook 通知。
WEBHOOK_METHOD (可选)	Webhook 请求方法。	否	支持 GET 或 POST，默认为 POST。
WEBHOOK_HEADERS (可选)	Webhook 的自定义请求头。	否	必须是有效的 JSON 字符串，例如 '{"Authorization": "Bearer xxx"}'。
WEBHOOK_CONTENT_TYPE (可选)	POST 请求的内容类型。	否	支持 JSON 或 FORM，默认为 JSON。
WEBHOOK_QUERY_PARAMETERS (可选)	GET 请求的查询参数。	否	JSON 字符串，支持 {{title}} 和 {{content}} 占位符。
WEBHOOK_BODY (可选)	POST 请求的请求体。	否	JSON 字符串，支持 {{title}} 和 {{content}} 占位符。
LOGIN_IS_EDGE	是否使用 Edge 浏览器进行登录和爬取。	否	默认为 false，使用 Chrome/Chromium。
PCURL_TO_MOBILE	是否在通知中将电脑版商品链接转换为手机版。	否	默认为 true。
RUN_HEADLESS	是否以无头模式运行爬虫浏览器。	否	默认为 true。在本地调试遇到验证码时可设为 false 手动处理。Docker部署时必须为 true。
AI_DEBUG_MODE	是否开启AI调试模式。	否	默认为 false。开启后会在控制台打印详细的AI请求和响应日志。
SERVER_PORT	Web UI服务的运行端口。	否	默认为 8000。
WEB_USERNAME	Web界面登录用户名。	否	默认为 admin。生产环境请务必修改。
WEB_PASSWORD	Web界面登录密码。	否	默认为 admin123。生产环境请务必修改为强密码。

必填的配置项为API Key、Base URL及Model Name。即下图显示的信息：

注意：
1.如果在配置AI API时遇到404错误，建议先使用阿里云或火山提供的API进行调试，确保基础功能正常后再尝试其他API提供商。某些API提供商可能存在兼容性问题或需要特殊的配置。
2.Web界面已启用Basic认证保护。默认用户名（WEB_USERNAME）和密码（WEB_PASSWORD）为 admin / admin123，生产环境请务必修改为强密码！