scylla

环境要求

• 已安装 Docker 环境
• 本机 8899 与 8081 端口未被占用
• 首次启动后需等待 1~2 分钟才有代理数据入库
• 如改用 pip 方式，需要本地 Python 环境与 pip

安装与启动步骤

1. 1启动 Docker 容器

   一条命令即可启动爬虫与 Web 服务，映射 8899 与 8081 两个端口，并把数据目录挂载到宿主机实现持久化。

   docker run -d -p 8899:8899 -p 8081:8081 -v /var/www/scylla:/var/www/scylla --name scylla wildcat/scylla:latest

   复制

2. 2确认容器在运行

   查看容器列表，确认 scylla 容器状态为 Up；若启动失败可用日志命令排查。

   docker ps
   docker logs scylla

   复制

3. 3调用 JSON API 验证

   浏览器或命令行访问代理列表接口，返回 JSON 即表示服务已正常对外提供接口。

   curl http://localhost:8899/api/v1/proxies

   复制

4. 4打开 Web 管理界面

   访问映射出的 8081 端口，可查看代理分布等可视化页面（以实际端口映射为准）。

5. 5备选：pip 方式安装

   不想用 Docker 时，可直接用 pip 安装并运行，同一进程同时跑爬虫与 JSON API 服务。

   pip install scylla
   scylla --help
   scylla

   复制

6. 6备选：源码方式安装

   从源码构建需额外安装前端依赖并执行 make assets-build，最后以模块方式启动。

   git clone https://github.com/imWildCat/scylla.git
   cd scylla
   pip install -r requirements.txt
   cd frontend
   npm install
   cd ..
   make assets-build
   python -m scylla

   复制

关键配置

如何确认成功

执行 curl http://localhost:8899/api/v1/proxies 能返回 JSON 列表，且等待 1~2 分钟后列表中出现可用代理 IP。

常见问题

注意事项

• 推荐使用 Docker 方式部署，命令最少、依赖隔离最好；源码方式需要额外的前端构建工具链。
• 数据目录建议挂载到宿主机，避免容器删除后代理数据丢失。
• 首次启动请预留 1~2 分钟等待代理 IP 抓取与校验完成，再判断服务是否正常。