v1.1.0: Alpine 轻量级 Docker 开发环境 + 敏感凭证清理

This commit is contained in:
lxy
2026-07-27 13:59:18 +08:00
parent feb76081a0
commit ccca0fa62b
51 changed files with 6125 additions and 993 deletions
+117
View File
@@ -0,0 +1,117 @@
# Flux 开发环境
> 当前在 ws-flux-dev 容器内
> 工作目录: /workspace (= E:/wk-flux)
## 项目概述
贷款撮合平台 (Flux),核心模块:
| 模块 | 技术栈 | 说明 |
|------|--------|------|
| flux-api | Java 17 + Redkale + Maven | 后端 API,核心业务 |
| flux-admin | Vue 3 + Arco Design + bun | 管理后台 |
| flux-uniapp | UniApp + Vite | H5 前端 |
| flux-mock | Go | 三方模拟服务 |
| flux-test | Go | 业务链测试 (撞库等) |
| file-server | Go | 文件上传下载 |
| flux-wechat-api | — | 微信服务端 |
## 代理工具(优先使用)
> **容器内代理服务由 .bashrc 自动启动**,无需手动启动。
> **所有数据库和远程操作必须通过代理工具执行**,禁止直接用 mysql/ssh/redis-cli。
### MySQL 查询
```bash
# 查询 (默认表格输出)
mysql-proxy cli -c flux_dev -e "SELECT * FROM users LIMIT 10"
# JSON 输出 (便于解析)
mysql-proxy cli -c flux_dev -e "SHOW TABLES" -F json
# 执行 DML (加 -x)
mysql-proxy cli -c flux_dev -e "UPDATE table SET status=1 WHERE id=1" -x
```
### SSH 远程执行
```bash
# 执行命令
ssh-proxy exec -n flux_dev -c "docker ps"
# JSON 输出
ssh-proxy exec -n flux_dev -c "docker ps" -F json
# 生产服务器 (byr_pro = prod_baiyarong)
ssh-proxy exec -n byr_pro -c "cd /opt/flux-api && bash bin/restart.sh"
```
### Redis 操作
```bash
# 取值
redis-proxy get -c flux_dev -k "session:user:123"
# 通用命令 (最灵活)
redis-proxy run -c flux_dev -C "KEYS" -a "user:*"
# 设置值
redis-proxy set -c flux_dev -k "key" -v "value"
```
## 开发命令
```bash
# ===== flux-api (Java/Redkale/Maven) =====
cd /workspace/flux-api
mvn clean package # 构建
cmd /c bin\restart.bat # 重启 (Windows bat,容器内需调整)
# ===== flux-admin (Vue3/bun) =====
cd /workspace/flux-admin
bun install # 安装依赖
bun run dev # 开发模式
# ===== flux-uniapp (UniApp) =====
cd /workspace/flux-uniapp
npm install
npm run dev:h5 # H5 模式
# ===== Go 服务 =====
cd /workspace/flux-mock && go run *.go
cd /workspace/flux-test && go run test_quick.go qulaijie -mode=collide
cd /workspace/file-server && go run *.go
```
## 连接信息速查
详细配置见:
- 服务器: `/root/.dev-env/servers.yaml`
- 数据库: `/root/.dev-env/databases.yaml`
- 规范: `/root/.dev-env/norms.md`
**快速参考**:
| 环境 | MySQL | Redis |
|------|-------|-------|
| 测试 (flux_dev) | 见 databases.yaml(不入库) | 见 databases.yaml :6379 |
| 生产 (flux_prox) | 见 databases.yaml(不入库) | — |
## 项目知识库
Flux 专属文档位于 `/root/.dev-env/docs/`
| 文件 | 用途 |
|------|------|
| Redkale使用易错点.md | **flux-api 必读** — 框架踩坑记录 |
| MySQL慢查询分析.md | SQL 慢查询优化参考 |
## 开发规范
> **唯一事实来源**: `/root/.dev-env/norms.md`
> 本文件不重复规范内容,避免维护不一致。
执行任务前先读取 norms.md,关键规则:
- Git 提交、代码审查、命名规范、高危操作检查清单
+1
View File
@@ -0,0 +1 @@
{"permissions": {"allow": ["Bash(mysql-proxy *)", "Bash(ssh-proxy *)", "Bash(redis-proxy *)", "Bash(mongo-proxy *)", "Bash(mvn *)", "Bash(java *)", "Bash(javac *)", "Bash(go *)", "Bash(bun *)", "Bash(npm *)", "Bash(node *)", "Bash(cmd *)", "Bash(git *)", "Bash(docker *)", "Bash(curl *)", "Bash(wget *)", "Bash(cat *)", "Bash(ls *)", "Bash(grep *)", "Bash(find *)", "Read", "Write", "Edit"], "deny": []}}