diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..f6b89d8
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,30 @@
+FROM python:3.10-slim
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set working directory
+WORKDIR /app
+
+# Copy requirements first for better caching
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY . .
+
+# Create data directory
+RUN mkdir -p data logs
+
+# Expose port
+EXPOSE 8000
+
+# Environment variables
+ENV PYTHONUNBUFFERED=1
+
+# Run the application
+CMD ["python", "webui.py"]
diff --git a/README.md b/README.md
index f331c9b..e2a9f93 100644
--- a/README.md
+++ b/README.md
@@ -195,6 +195,57 @@ codex-register-v2/
 | `ws://host/api/ws/task/{uuid}` | 单任务实时日志 |
 | `ws://host/api/ws/batch/{id}` | 批量任务实时状态与日志 |
 
+## Docker 部署
+
+### 环境要求
+
+- Docker
+- Docker Compose
+
+### 快速部署
+
+```bash
+# 克隆项目
+git clone https://github.com/cnlimiter/codex-register.git
+cd codex-register
+
+# 启动服务
+docker-compose up -d
+```
+
+服务启动后访问 http://localhost:8000
+
+### 配置说明
+
+**端口映射**：默认 `8000` 端口，可在 `docker-compose.yml` 中修改。
+
+**数据持久化**：
+```yaml
+volumes:
+  - ./data:/app/data
+  - ./logs:/app/logs
+```
+
+**代理配置**：
+```yaml
+environment:
+  - HTTP_PROXY=http://your-proxy:port
+  - HTTPS_PROXY=http://your-proxy:port
+```
+
+### 常用命令
+
+```bash
+# 查看日志
+docker-compose logs -f
+
+# 停止服务
+docker-compose down
+
+# 重新构建
+docker-compose build --no-cache
+```
+
 ## 注意事项
 
 - 首次运行会自动创建 `data/` 目录和 SQLite 数据库
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000..cab624b
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,18 @@
+version: '3.8'
+
+services:
+  codex-register:
+    build: .
+    container_name: codex-register
+    ports:
+      - "8000:8000"
+    volumes:
+      - ./data:/app/data
+      - ./logs:/app/logs
+    environment:
+      - PYTHONUNBUFFERED=1
+    restart: unless-stopped
+    # 如果需要代理，取消下面注释并修改地址
+    # environment:
+    #   - HTTP_PROXY=http://your-proxy:port
+    #   - HTTPS_PROXY=http://your-proxy:port