从开发到分享：Docker + GitHub 完整部署指南（以 Domain Checker 为例）

1
domain-checker/
2
├── docker-compose.yml      # Docker Compose 配置
3
├── .env.example            # 环境变量模板（给别人参考）
4
├── .env                    # 真实环境变量（本地用，不上传）
5
├── .gitignore              # Git 忽略规则
6
├── README.md               # 项目说明
7
├── Dockerfile              # Docker 镜像定义
8
├── requirements.txt        # Python 依赖
9
└── main.py                 # 应用代码

1
from fastapi import FastAPI
2
import os
3

4
app = FastAPI(title="Domain Checker")
5

6
FASTLY_TOKEN = os.getenv("FASTLY_TOKEN", "")
7
MAX_CONCURRENCY = int(os.getenv("MAX_CONCURRENCY", "5"))
8

9
@app.get("/")
10
async def index():
11
    return {
12
        "message": "Domain Checker API",
13
        "token_configured": bool(FASTLY_TOKEN),
14
        "max_concurrency": MAX_CONCURRENCY
15
    }
16

17
@app.get("/health")
18
async def health():
19
    return {"status": "ok"}

1
fastapi==0.104.1
2
uvicorn==0.24.0
3
httpx==0.25.2
4
pytz==2024.1
5
python-multipart==0.0.6

1
FROM python:3.12-slim
2

3
ENV PYTHONDONTWRITEBYTECODE=1 \
4
    PYTHONUNBUFFERED=1
5

6
WORKDIR /app
7

8
RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates && rm -rf /var/lib/apt/lists/*
9

10
COPY requirements.txt .
11
RUN pip install --no-cache-dir -r requirements.txt
12

13
COPY . .
14

15
EXPOSE 8000
16
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

1
version: '3.8'
2
services:
3
  domain-checker:
4
    image: myhywo/domain-checker:latest
5
    container_name: domain-checker
6
    restart: unless-stopped
7
    ports:
8
      - "22332:8000"
9
    volumes:
10
      - ./data:/app/data
11
      - ./wordlists:/app/wordlists
12
    environment:
13
      - MAX_CONCURRENCY=5
14
      - HTTP_TIMEOUT_SECONDS=10
15
      - CACHE_TTL_SECONDS=86400
16
      - FASTLY_TOKEN=your_fastly_api_token_here
17
      - FASTLY_ENDPOINT=https://api.fastly.com/domain-management/v1/tools/status
18
      - RESET_DAY=18
19
      - RESET_TIMEZONE=Asia/Shanghai
20
networks:
21
  default:
22
    name: domain-checker-net

1
# Fastly API Configuration
2
FASTLY_TOKEN=your_fastly_api_token_here
3
FASTLY_ENDPOINT=https://api.fastly.com/domain-management/v1/tools/status
4

5
# Application Settings
6
MAX_CONCURRENCY=5
7
HTTP_TIMEOUT_SECONDS=10
8
CACHE_TTL_SECONDS=86400
9

10
# Reset Configuration
11
RESET_DAY=18
12
RESET_TIMEZONE=Asia/Shanghai

1
FASTLY_TOKEN=your_real_token_here
2
FASTLY_ENDPOINT=https://api.fastly.com/domain-management/v1/tools/status
3
MAX_CONCURRENCY=5
4
HTTP_TIMEOUT_SECONDS=10
5
CACHE_TTL_SECONDS=86400
6
RESET_DAY=18
7
RESET_TIMEZONE=Asia/Shanghai

1
.env
2
.env.local
3
*.log
4
app/__pycache__/
5
app/*.pyc
6
data/
7
.DS_Store

1
services:
2
  domain-checker:
3
    image: myhywo/domain-checker:latest
4
    container_name: domain-checker
5
    restart: unless-stopped
6
    ports:
7
      - "22332:8000"
8
    volumes:
9
      - ./app:/app
10
    environment:
11
      - MAX_CONCURRENCY=5
12
      - HTTP_TIMEOUT_SECONDS=10
13
      - CACHE_TTL_SECONDS=86400
14
      - FASTLY_TOKEN=their_token_here
15
      - FASTLY_ENDPOINT=https://api.fastly.com/domain-management/v1/tools/status
16
      - RESET_DAY=18
17
      - RESET_TIMEZONE=Asia/Shanghai

1
image: myhywo/domain-checker:v1.0.0  # 指定版本
2
# 或
3
image: myhywo/domain-checker:latest  # 最新版本

1
environment:
2
  - FASTLY_TOKEN=${FASTLY_TOKEN}  # 从 .env 读取

1
environment:
2
  - FASTLY_TOKEN=abc123xyz  # 硬编码，会泄露！

1
healthcheck:
2
  test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
3
  interval: 30s
4
  timeout: 10s
5
  retries: 3
6
  start_period: 40s

1
logging:
2
  driver: "json-file"
3
  options:
4
    max-size: "10m"
5
    max-file: "3"

1
deploy:
2
  resources:
3
    limits:
4
      cpus: '1'
5
      memory: 512M
6
    reservations:
7
      cpus: '0.5'
8
      memory: 256M

1
volumes:
2
  - ./app:/app          # 代码（开发时热重载）
3
  - ./data:/app/data    # 数据（持久化）

1
image: myhywo/domain-checker:v1.0.0  # 改成旧版本