常见项目克隆下载问题汇总以及解决办法

1.GitHub克隆时连接不上

查看当前git配置

git config --global-l

使用github克隆时，遇到连接不上时，重新设置git配置。

git config --global http.version HTTP/1.1

git clone https://ghfast.top/项目地址

2.requirements依赖冲突问题

创建新环境，激活

conda create -n 名称 python=3.12

conda activate 名称

pip install -r requirements.txt

3.项目安装依赖也可以到pycharm里面

先cd到相关目录，然后安装

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

4.遇到依赖冲突，在其中应该环境下先建立虚拟环境，然后在该环境下进行重装依赖

比如，ctfSolver项目中，agent和backend的依赖冲突了。

在agent目录创建虚拟环境

cd agent python -m venv venv

.\venv\Scripts\activate

pip install --upgrade pip pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

5.docker镜像源拉取问题，一直连不上，可以考虑换镜像源，或者改成本地构建镜像，不pull

换镜像源，我尝试多次仍然不行，原来是docker-compose.yaml代码有问题，build方法写得不恰当导致的。

以下是ctfSolver中解决该问题的办法（方法来自于ChatGPT,我用的方案A就解决了）

✅ 方案 A（强烈推荐）：改成「本地构建镜像」，不 pull

我看过你的项目结构（server/backend / server/frontend）， 它本来就应该 build，而不是 pull。

1️⃣ 打开 server/docker-compose.yaml

你现在大概率是这样的：

services: `` backend: `` image: python:3.9-slim

❌ 这是问题根源。

---

2️⃣ 改成 build（这是正确写法）

services:
  backend:
    image: python:3.9-slim

---

3️⃣ backend/Dockerfile 必须是完整的

比如：

services:
  backend:
    build:
      context: ./backend
      dockerfile: Dockerfile
    container_name: ctfsolver-backend
    ports:
      - "5000:5000"

  frontend:
    build:
      context: ./frontend
      dockerfile: Dockerfile
    container_name: ctfsolver-frontend
    ports:
      - "85:80"

⚠️ 注意：

• pip 源换成清华

• 只剩下一个地方还会碰 Docker Hub：python:3.9-slim

---

✅ 方案 B：把基础镜像也彻底"国产化"

这是核武器方案，成功率 100%。

1️⃣ 改 Dockerfile：

FROM registry.cn-hangzhou.aliyuncs.com/library/python:3.9-slim

阿里云官方同步镜像，不走 Docker Hub。

---

2️⃣ 登录阿里云镜像仓库（一次即可）

docker login registry.cn-hangzhou.aliyuncs.com

---

3️⃣ 再跑

docker compose build docker compose up -d

6.开发环境与WSGI

Flask 开发服务器 → Gunicorn WSGI Server

后端Flask代码中保留app = Flask(name)，同时app.py中的启动方式

gunicorn -w 4 -b 0.0.0.0:5000 app:app  #-w 4表示4个worker，app:app的含义前一个app=app.py，后一个app=Flask实例名

Dockerfile中的启动方式

CMD ["gunicorn", "-w", "4", "-b", "0.0.0.0:5000", "app:app"] 

Docker重构

docker-compose down #停掉之前的
docker-compose up -d build #重新构建
docker-compose logs -f flask-app #启动且查看日志