# 🛠️ 轻程智能科技工作室 - 开发测试环境搭建文档

**版本**: v1.0  
**创建时间**: 2026-04-04  
**创建者**: 虾子 AI  
**环境**: OpenCloudOS 9.4 + Nginx + OpenClaw

---

## 📋 目录

1. [环境架构](#环境架构)
2. [开发环境 (本地)](#开发环境本地)
3. [测试环境 (服务器)](#测试环境服务器)
4. [生产环境](#生产环境)
5. [快速部署脚本](#快速部署脚本)
6. [使用指南](#使用指南)

---

## 环境架构

### 环境对比

| 环境 | 位置 | Web 端口 | 网关端口 | 用途 |
|------|------|----------|----------|------|
| **开发** | 本地电脑 | 8080 | 19001 | 日常开发调试 |
| **测试** | 118.25.113.60 | 8080 | 26107 | 功能测试/演示 |
| **生产** | 118.25.113.60 | 80 | 26106 | 客户正式使用 |

### 访问地址

| 环境 | 访问地址 | 说明 |
|------|----------|------|
| **开发** | http://localhost:8080 | 本地访问 |
| **测试** | http://118.25.113.60:8080 | 公网访问 |
| **生产** | http://qingcheng.work | 域名访问 |

---

## 开发环境 (本地)

### 必备软件

| 软件 | 版本 | 用途 | 下载地址 |
|------|------|------|----------|
| Node.js | ≥22.x | OpenClaw 运行环境 | https://nodejs.org/ |
| Git | 最新 | 代码版本管理 | https://git-scm.com/ |
| VS Code | 最新 | 代码编辑器 | https://code.visualstudio.com/ |

### 安装步骤

#### 1. 安装 Node.js

```bash
# Windows/Mac: 下载安装包安装
# Linux:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node --version  # v22.x
npm --version   # 10.x
```

#### 2. 安装 Git

```bash
# Windows: 下载安装
# Mac: brew install git
# Linux:
sudo apt-get install -y git

# 验证
git --version
```

#### 3. 安装 VS Code

```bash
# Windows/Mac: 下载安装
# Linux:
sudo snap install --classic code

# 推荐插件:
- ESLint
- Prettier
- GitLens
- Docker
- Remote - SSH
```

### 本地 OpenClaw 开发环境

```bash
# 1. 创建开发目录
mkdir -p ~/dev/qingcheng
cd ~/dev/qingcheng

# 2. 安装 OpenClaw
npm install -g openclaw@latest

# 3. 初始化开发环境
openclaw onboard

# 4. 启动开发网关
openclaw --dev gateway

# 访问：http://localhost:19001
```

### 本地测试服务

```bash
# 方式 1: Python (简单快速)
cd ~/dev/qingcheng
python3 -m http.server 8080

# 方式 2: Node.js
npm install -g http-server
http-server -p 8080

# 访问：http://localhost:8080
```

---

## 测试环境 (服务器)

### 已部署服务

| 服务 | 端口 | 状态 | 用途 |
|------|------|------|------|
| **Nginx** | 80 | ✅ 运行 | 生产官网 |
| **Nginx (测试)** | 8080 | ✅ 运行 | 测试网站 |
| **OpenClaw** | 26106 | ✅ 运行 | 生产网关 |

### 测试环境访问

```
公网地址：http://118.25.113.60:8080
本地访问：http://localhost:8080
```

### 测试页面内容

- ✅ 工作室品牌展示
- ✅ 环境信息展示
- ✅ 实时时间显示
- ✅ 响应式设计

### 管理命令

```bash
# 查看 Nginx 状态
systemctl status nginx

# 重启 Nginx
systemctl restart nginx

# 查看访问日志
tail -f /var/log/nginx/access.log

# 查看错误日志
tail -f /var/log/nginx/error.log

# 查看端口占用
netstat -tlnp | grep 8080
```

---

## 生产环境

### 已部署服务

| 服务 | 地址 | 状态 |
|------|------|------|
| **官网** | http://118.25.113.60/ | ✅ 运行 |
| **OpenClaw** | 本地 26106 端口 | ✅ 运行 |
| **QQ Bot** | 已启用 | ✅ 运行 |
| **微信 Bot** | 已启用 | ✅ 运行 |

### 域名配置 (待完成)

```
域名：qingcheng.work
DNS: 解析到 118.25.113.60
```

---

## 快速部署脚本

### 一键部署测试环境

```bash
# 执行部署脚本
bash /root/.openclaw/workspace/deploy-test.sh
```

### 脚本功能

1. ✅ 创建测试目录 `/var/www/test`
2. ✅ 创建测试页面
3. ✅ 配置 Nginx (8080 端口)
4. ✅ 配置防火墙
5. ✅ 测试并重启 Nginx
6. ✅ 验证部署

### 手动部署步骤

如果脚本失败，可手动执行：

```bash
# 1. 创建测试目录
sudo mkdir -p /var/www/test
sudo chown $USER:$USER /var/www/test

# 2. 创建测试页面 (见 /var/www/test/index.html)

# 3. 配置 Nginx
sudo nano /etc/nginx/nginx.conf
# 在文件末尾添加 server 块 (见配置示例)

# 4. 测试配置
sudo nginx -t

# 5. 重启 Nginx
sudo systemctl restart nginx

# 6. 验证
curl http://localhost:8080
```

---

## 使用指南

### 开发流程

```
1. 本地开发 (localhost:8080)
   ↓
2. 本地测试通过
   ↓
3. 部署到服务器测试环境 (118.25.113.60:8080)
   ↓
4. 测试环境验证
   ↓
5. 部署到生产环境 (qingcheng.work)
```

### 环境切换

#### 开发 → 测试

```bash
# 1. 本地打包
cd ~/dev/qingcheng
tar -czf release.tar.gz .

# 2. 上传到服务器
scp release.tar.gz root@118.25.113.60:/tmp/

# 3. 服务器部署
ssh root@118.25.113.60
cd /var/www/test
tar -xzf /tmp/release.tar.gz
```

#### 测试 → 生产

```bash
# 1. 备份生产环境
cp -r /var/www/html /var/www/html.backup.$(date +%Y%m%d)

# 2. 部署新版本
cp -r /var/www/test/* /var/www/html/

# 3. 验证
curl http://118.25.113.60/
```

### 常见问题

#### Q1: 8080 端口无法访问

```bash
# 检查防火墙
sudo firewall-cmd --list-ports

# 开放端口
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload
```

#### Q2: Nginx 启动失败

```bash
# 查看错误
sudo nginx -t
sudo systemctl status nginx

# 查看日志
tail -f /var/log/nginx/error.log
```

#### Q3: 权限问题

```bash
# 修复权限
sudo chown -R $USER:$USER /var/www/test
sudo chmod -R 755 /var/www/test
```

---

## 安全配置

### Nginx 安全头部

```nginx
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-XSS-Protection "1; mode=block" always;
```

### 防火墙配置

```bash
# 开放必要端口
sudo firewall-cmd --permanent --add-service=ssh
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload
```

### 访问限制 (可选)

```nginx
# 限制 IP 访问测试环境
location / {
    allow 118.25.113.60;  # 允许服务器 IP
    allow 127.0.0.1;      # 允许本地
    deny all;             # 拒绝其他
}
```

---

## 监控与维护

### 日志监控

```bash
# 实时查看访问日志
tail -f /var/log/nginx/access.log

# 实时查看错误日志
tail -f /var/log/nginx/error.log

# 查看今日错误
grep $(date +%Y/%m/%d) /var/log/nginx/error.log
```

### 性能监控

```bash
# 查看 Nginx 状态
systemctl status nginx

# 查看端口占用
netstat -tlnp | grep nginx

# 查看进程
ps aux | grep nginx
```

### 定期维护

```bash
# 每周清理日志
find /var/log/nginx -name "*.log" -mtime +7 -delete

# 每月备份配置
cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.backup.$(date +%Y%m)

# 每季度更新系统
sudo yum update -y
```

---

## 附录

### A. 配置文件位置

| 配置文件 | 路径 |
|----------|------|
| Nginx 主配置 | /etc/nginx/nginx.conf |
| 测试环境配置 | /var/www/test/ |
| 生产环境配置 | /var/www/html/ |
| Nginx 日志 | /var/log/nginx/ |

### B. 常用端口

| 端口 | 服务 | 用途 |
|------|------|------|
| 22 | SSH | 远程管理 |
| 80 | Nginx | 生产 Web |
| 8080 | Nginx | 测试 Web |
| 26106 | OpenClaw | 生产网关 |
| 26107 | OpenClaw | 测试网关 (可选) |

### C. 相关文档

- [腾讯企业邮配置](/qc-mail-config.md)
- [创业行动计划](/qc.md)
- [MEMORY.md](/root/.openclaw/workspace/MEMORY.md)

---

**文档版本**: v1.0  
**最后更新**: 2026-04-04 19:00 GMT+8  
**维护者**: 虾子 AI  
**轻程智能科技工作室** · 内部文档

---

*🦐 轻程智能科技工作室 - 轻量化智能，成就大未来*