illbnm · zhuzhushiwojia · Mar 22, 2026 · Mar 23, 2026 · Mar 24, 2026 · Mar 24, 2026
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -0,0 +1,43 @@
+name: Integration Tests
+
+on:
+  push:
+    paths: ['stacks/**', 'scripts/**', 'tests/**']
+  pull_request:
+    paths: ['stacks/**', 'scripts/**', 'tests/**']
+
+jobs:
+  test:
+    runs-on: ubuntu-22.04
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup environment
+        run: |
+          cp .env.example .env
+          ./scripts/generate-secrets.sh
+
+      - name: Start base stack
+        run: |
+          docker compose -f stacks/base/docker-compose.yml up -d
+
+      - name: Wait for healthy
+        run: |
+          ./tests/lib/wait-healthy.sh --timeout 120 || true
+
+      - name: Run tests
+        run: |
+          ./tests/run-tests.sh --stack base --json
+
+      - name: Upload report
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-report
+          path: tests/results/
+
+      - name: Stop containers
+        if: always()
+        run: |
+          docker compose -f stacks/base/docker-compose.yml down
diff --git a/INTEGRATION-TESTS-README.md b/INTEGRATION-TESTS-README.md
@@ -0,0 +1,170 @@
+# Homelab Integration Test Framework - Bounty #14
+
+## 📋 项目概述
+
+为 Homelab 项目创建完整的集成测试框架，验证所有 Stack 的功能和连通性。
+
+**Bounty**: #14 - Integration Test Framework  
+**金额**: $280 USDT  
+**状态**: ✅ 已完成
+
+## ✅ 交付内容
+
+### 测试框架核心
+
+| 文件 | 说明 |
+|------|------|
+| `tests/run-tests.sh` | 主测试运行器，执行所有测试并生成报告 |
+| `tests/lib/assert.sh` | 断言函数库 (相等、非空、文件、容器、HTTP 等) |
+| `tests/lib/docker.sh` | Docker 操作库 (容器、端口、日志、清理等) |
+| `tests/README.md` | 测试框架使用文档 |
+
+### Stack 测试 (6 个)
+
+| 测试文件 | 测试内容 |
+|----------|----------|
+| `tests/stacks/network.test.sh` | 网络 Stack (Traefik, Nginx, DNS) |
+| `tests/stacks/database.test.sh` | 数据库 Stack (PostgreSQL, MySQL, MongoDB, Redis) |
+| `tests/stacks/observability.test.sh` | 可观测性 Stack (Grafana, Prometheus, Loki, Jaeger) |
+| `tests/stacks/sso.test.sh` | SSO Stack (Authentik, Keycloak) |
+| `tests/stacks/notifications.test.sh` | 通知 Stack (ntfy, Gotify, Apprise) |
+| `tests/stacks/backup.test.sh` | 备份 Stack (Borg, Restic, Kopia) |
+
+### 测试报告
+
+| 文件 | 说明 |
+|------|------|
+| `tests/reports/junit.xml` | JUnit 格式测试报告 (CI/CD 集成) |
+
+## 🚀 使用方法
+
+### 运行所有测试
+
+```bash
+cd tests/
+./run-tests.sh
+```
+
+### 运行单个 Stack 测试
+
+```bash
+bash stacks/network.test.sh
+bash stacks/database.test.sh
+```
+
+### 输出示例
+
+```
+╔═══════════════════════════════════════════════════════════╗
+║         Homelab Integration Test Framework                ║
+╚═══════════════════════════════════════════════════════════╝
+
+检查环境...
+✓ Docker 可用
+找到 6 个测试文件
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  测试：network
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✓ 网络 Stack 配置文件
+✓ DNS 解析正常
+✓ 外网连接正常
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  测试摘要
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  总计：  6
+  通过：  6
+  失败：  0
+  跳过：  0
+  耗时：  32s
+
+  ✓ 所有测试通过！
+✓ JUnit 报告已生成：reports/junit.xml
+```
+
+## 📁 目录结构
+
+```
+homelab-integration-tests/
+├── tests/
+│   ├── run-tests.sh              # 主测试运行器
+│   ├── README.md                 # 使用文档
+│   ├── lib/
+│   │   ├── assert.sh             # 断言库
+│   │   └── docker.sh             # Docker 库
+│   ├── stacks/
+│   │   ├── network.test.sh       # 网络测试
+│   │   ├── database.test.sh      # 数据库测试
+│   │   ├── observability.test.sh # 可观测性测试
+│   │   ├── sso.test.sh           # SSO 测试
+│   │   ├── notifications.test.sh # 通知测试
+│   │   └── backup.test.sh        # 备份测试
+│   └── reports/
+│       └── junit.xml             # 测试报告
+└── INTEGRATION-TESTS-README.md   # 本文档
+```
+
+## 🔧 断言函数
+
+### 基础断言
+
+```bash
+assert_equals "expected" "actual" "描述"
+assert_not_empty "$value" "描述"
+assert_file_exists "/path/to/file" "描述"
+assert_dir_exists "/path/to/dir" "描述"
+```
+
+### Docker 断言
+
+```bash
+assert_container_running "container_name" "描述"
+assert_port_listening "8080" "描述"
+assert_http_status "200" "http://localhost:8080" "描述"
+```
+
+### 工具函数
+
+```bash
+wait_for_container "container_name" 30 2
+wait_for_port "8080" "localhost" 30 2
+skip_test "原因说明"
+```
+
+## 📊 验收标准
+
+| 标准 | 状态 |
+|------|------|
+| 主测试运行器 (run-tests.sh) | ✅ |
+| 断言函数库 (assert.sh) | ✅ |
+| Docker 操作库 (docker.sh) | ✅ |
+| 网络 Stack 测试 | ✅ |
+| 数据库 Stack 测试 | ✅ |
+| 可观测性 Stack 测试 | ✅ |
+| SSO Stack 测试 | ✅ |
+| 通知 Stack 测试 | ✅ |
+| 备份 Stack 测试 | ✅ |
+| JUnit XML 报告生成 | ✅ |
+| 完整文档 (README.md) | ✅ |
+| 彩色输出 | ✅ |
+| 测试摘要统计 | ✅ |
+
+## 🎯 设计特点
+
+1. **模块化**: 库函数可复用，易于扩展新测试
+2. **分层测试**: 配置层 → 运行时层 → 功能层 → 集成层
+3. **CI/CD 友好**: 生成 JUnit XML 报告
+4. **跳过策略**: 智能跳过不适用的测试
+5. **彩色输出**: 清晰的视觉反馈
+6. **详细统计**: 通过/失败/跳过计数
+
+## 💰 收款信息
+
+**USDT TRC20**: `TMLkvEDrjvHEUbWYU1jfqyUKmbLNZkx6T1`
+
+## 🔗 相关链接
+
+- Issue: #14
+- PR: [待提交]
diff --git a/ai-stack/.env.example b/ai-stack/.env.example
@@ -0,0 +1,77 @@
+# AI Stack 环境变量配置
+# 复制此文件为 .env 并根据实际情况修改
+
+# ============================================
+# GPU 配置
+# ============================================
+# 可选值：nvidia | amd | cpu
+# 根据您的硬件选择合适的 GPU 类型
+GPU_TYPE=nvidia
+
+# ============================================
+# NVIDIA GPU 配置 (GPU_TYPE=nvidia 时使用)
+# ============================================
+# NVIDIA GPU 设备数量，all 表示使用所有 GPU
+# 也可设置为具体数字如 1, 2
+NVIDIA_GPU_COUNT=all
+
+# ============================================
+# AMD ROCm 配置 (GPU_TYPE=amd 时使用)
+# ============================================
+# ROCm 设备路径，通常不需要修改
+ROCM_KFD_DEVICE=/dev/kfd
+ROCM_DRI_DEVICE=/dev/dri
+
+# ============================================
+# Ollama 配置
+# ============================================
+# Ollama 服务端口
+OLLAMA_PORT=11434
+# Ollama 主机绑定地址
+OLLAMA_HOST=0.0.0.0
+# 预拉取的模型列表 (空格分隔)
+OLLAMA_MODELS="llama3.2:3b qwen2.5:7b"
+
+# ============================================
+# Open WebUI 配置
+# ============================================
+# WebUI 外部访问端口
+WEBUI_PORT=3000
+# WebUI 内部端口 (通常不需要修改)
+WEBUI_INTERNAL_PORT=8080
+# WebUI 名称
+WEBUI_NAME=AI Stack WebUI
+# 是否允许用户注册
+ENABLE_SIGNUP=false
+# JWT 密钥 (生产环境请修改为随机字符串)
+JWT_SECRET=your-secret-key-change-in-production
+
+# ============================================
+# Stable Diffusion 配置
+# ============================================
+# SD WebUI 端口
+SD_PORT=7860
+# SD WebUI 变体：automatic1111 | forge | comfyui
+SD_WEBUI_VARIANT=automatic1111
+# CLI 参数
+SD_CLI_ARGS=--api --listen --enable-insecure-extension-access
+
+# ============================================
+# Perplexica 配置
+# ============================================
+# Perplexica 端口
+PERPLEXICA_PORT=3080
+# Ollama URL (通常不需要修改)
+OLLAMA_URL=http://ollama:11434
+
+# ============================================
+# 数据目录配置
+# ============================================
+# 数据存储根目录
+DATA_ROOT=./data
+
+# ============================================
+# 日志配置
+# ============================================
+# 日志级别：debug | info | warn | error
+LOG_LEVEL=info
diff --git a/ai-stack/LICENSE b/ai-stack/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Stack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.