docs: 部署文档添加移动端发布和访问说明
更新： - deploy.sh: 添加移动端部署命令 * mobile dev - 启动开发服务器 * mobile h5 - 构建H5版本 * mobile mp-weixin - 构建微信小程序 * mobile app - 构建App * 服务启动时显示移动端访问地址 新增： - MOBILE_DEPLOY.md: 移动端部署指南（173行） * 支持平台说明（H5/小程序/App） * 快速部署步骤 * 各平台构建和发布流程 * 配置说明和常见问题 访问地址： - H5: http://localhost/mobile - 开发调试: cd fund-mobile && npm run dev:h5
This commit is contained in:
zhangjf
parent
515590477b
commit
b38940cf83
172
docker/app/MOBILE_DEPLOY.md
Normal file
172
docker/app/MOBILE_DEPLOY.md
Normal file
@ -0,0 +1,172 @@
|
|||||||
|
# 移动端部署指南
|
||||||
|
|
||||||
|
## 📱 支持平台
|
||||||
|
|
||||||
|
- **H5** - 浏览器访问
|
||||||
|
- **微信小程序** - 微信生态
|
||||||
|
- **App** - Android/iOS原生应用
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 快速部署
|
||||||
|
|
||||||
|
### 1. 开发调试
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd docker/app
|
||||||
|
./deploy.sh mobile dev
|
||||||
|
```
|
||||||
|
|
||||||
|
访问地址：http://localhost:5173
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2. H5部署
|
||||||
|
|
||||||
|
#### 构建
|
||||||
|
```bash
|
||||||
|
./deploy.sh mobile h5
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 部署到Nginx
|
||||||
|
构建完成后，将 `fund-mobile/dist/build/h5` 目录复制到Nginx静态资源目录：
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 复制到Nginx
|
||||||
|
sudo cp -r ../../fund-mobile/dist/build/h5 /var/www/fund-mobile
|
||||||
|
|
||||||
|
# 配置Nginx（已包含在docker-compose.yml中）
|
||||||
|
# 访问地址：http://localhost/mobile
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 3. 微信小程序部署
|
||||||
|
|
||||||
|
#### 构建
|
||||||
|
```bash
|
||||||
|
./deploy.sh mobile mp-weixin
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 发布步骤
|
||||||
|
1. 下载并安装 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)
|
||||||
|
2. 打开微信开发者工具
|
||||||
|
3. 选择 "导入项目"
|
||||||
|
4. 选择目录 `fund-mobile/dist/build/mp-weixin`
|
||||||
|
5. 填写小程序AppID（测试号可跳过）
|
||||||
|
6. 点击 "上传" 按钮发布
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 4. App部署
|
||||||
|
|
||||||
|
#### 构建
|
||||||
|
```bash
|
||||||
|
./deploy.sh mobile app
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Android打包
|
||||||
|
1. 打开 HBuilderX
|
||||||
|
2. 导入项目 `fund-mobile`
|
||||||
|
3. 点击 "发行" → "原生App-云打包"
|
||||||
|
4. 选择 Android 证书
|
||||||
|
5. 点击 "打包"
|
||||||
|
|
||||||
|
#### iOS打包
|
||||||
|
1. 需要Mac电脑和Apple开发者账号
|
||||||
|
2. 在 HBuilderX 中选择 "发行" → "原生App-云打包"
|
||||||
|
3. 选择 iOS 证书
|
||||||
|
4. 点击 "打包"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 部署命令汇总
|
||||||
|
|
||||||
|
| 命令 | 说明 |
|
||||||
|
|------|------|
|
||||||
|
| `./deploy.sh mobile dev` | 启动开发服务器 |
|
||||||
|
| `./deploy.sh mobile h5` | 构建H5版本 |
|
||||||
|
| `./deploy.sh mobile mp-weixin` | 构建微信小程序 |
|
||||||
|
| `./deploy.sh mobile app` | 构建App |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔧 配置说明
|
||||||
|
|
||||||
|
### API地址配置
|
||||||
|
|
||||||
|
编辑 `fund-mobile/src/config/api.ts`：
|
||||||
|
|
||||||
|
```typescript
|
||||||
|
// 开发环境
|
||||||
|
const API_BASE_URL = 'http://localhost:8080'
|
||||||
|
|
||||||
|
// 生产环境（部署后修改为实际地址）
|
||||||
|
const API_BASE_URL = 'http://your-domain.com'
|
||||||
|
```
|
||||||
|
|
||||||
|
### 微信小程序配置
|
||||||
|
|
||||||
|
编辑 `fund-mobile/src/manifest.json`：
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"mp-weixin": {
|
||||||
|
"appid": "你的小程序AppID",
|
||||||
|
"setting": {
|
||||||
|
"urlCheck": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📱 访问方式
|
||||||
|
|
||||||
|
### H5访问
|
||||||
|
- 浏览器访问：`http://localhost/mobile`
|
||||||
|
- 手机扫码访问：部署后生成二维码
|
||||||
|
|
||||||
|
### 微信小程序
|
||||||
|
- 微信搜索小程序名称
|
||||||
|
- 扫码体验版二维码
|
||||||
|
|
||||||
|
### App
|
||||||
|
- 下载安装APK/IPA文件
|
||||||
|
- 应用商店搜索下载
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔒 安全说明
|
||||||
|
|
||||||
|
1. **HTTPS**：生产环境必须使用HTTPS
|
||||||
|
2. **Token存储**：使用uni-app安全存储API
|
||||||
|
3. **接口鉴权**：所有接口需要JWT Token
|
||||||
|
4. **图片上传**：限制文件大小和类型
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🐛 常见问题
|
||||||
|
|
||||||
|
### Q1: H5页面空白
|
||||||
|
- 检查API地址是否正确
|
||||||
|
- 查看浏览器控制台错误信息
|
||||||
|
- 确认后端服务已启动
|
||||||
|
|
||||||
|
### Q2: 微信小程序无法请求
|
||||||
|
- 检查小程序后台配置的request合法域名
|
||||||
|
- 开发阶段可关闭域名校验
|
||||||
|
- 确保使用HTTPS
|
||||||
|
|
||||||
|
### Q3: App无法安装
|
||||||
|
- Android：开启"允许安装未知来源应用"
|
||||||
|
- iOS：需要信任企业证书
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📞 技术支持
|
||||||
|
|
||||||
|
- 前端问题：检查uni-app官方文档
|
||||||
|
- 后端问题：查看Swagger文档 http://localhost:8080/swagger-ui.html
|
||||||
|
- 部署问题：查看Docker日志 `docker-compose logs`
|
||||||
213
docker/app/deploy.sh
Executable file
213
docker/app/deploy.sh
Executable file
@ -0,0 +1,213 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# 资金服务平台部署脚本
|
||||||
|
|
||||||
|
set -e
|
||||||
|
|
||||||
|
echo "========================================"
|
||||||
|
echo " 资金服务平台 Docker 部署脚本"
|
||||||
|
echo "========================================"
|
||||||
|
|
||||||
|
# 颜色定义
|
||||||
|
RED='\033[0;31m'
|
||||||
|
GREEN='\033[0;32m'
|
||||||
|
YELLOW='\033[1;33m'
|
||||||
|
NC='\033[0m' # No Color
|
||||||
|
|
||||||
|
# 函数：打印信息
|
||||||
|
print_info() {
|
||||||
|
echo -e "${GREEN}[INFO]${NC} $1"
|
||||||
|
}
|
||||||
|
|
||||||
|
print_warn() {
|
||||||
|
echo -e "${YELLOW}[WARN]${NC} $1"
|
||||||
|
}
|
||||||
|
|
||||||
|
print_error() {
|
||||||
|
echo -e "${RED}[ERROR]${NC} $1"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 检查Docker
|
||||||
|
if ! command -v docker &> /dev/null; then
|
||||||
|
print_error "Docker 未安装，请先安装 Docker"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
if ! command -v docker-compose &> /dev/null; then
|
||||||
|
print_error "Docker Compose 未安装，请先安装 Docker Compose"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# 创建必要的目录
|
||||||
|
print_info "创建必要的目录..."
|
||||||
|
mkdir -p logs/fund-sys logs/fund-cust logs/fund-proj
|
||||||
|
mkdir -p init
|
||||||
|
mkdir -p redis
|
||||||
|
|
||||||
|
# 创建Redis配置文件
|
||||||
|
if [ ! -f redis/redis.conf ]; then
|
||||||
|
print_info "创建 Redis 配置文件..."
|
||||||
|
cat > redis/redis.conf << 'EOF'
|
||||||
|
bind 0.0.0.0
|
||||||
|
port 6379
|
||||||
|
timeout 0
|
||||||
|
tcp-keepalive 300
|
||||||
|
daemonize no
|
||||||
|
supervised no
|
||||||
|
pidfile /var/run/redis_6379.pid
|
||||||
|
loglevel notice
|
||||||
|
logfile ""
|
||||||
|
databases 16
|
||||||
|
always-show-logo no
|
||||||
|
save 900 1
|
||||||
|
save 300 10
|
||||||
|
save 60 10000
|
||||||
|
stop-writes-on-bgsave-error yes
|
||||||
|
rdbcompression yes
|
||||||
|
rdbchecksum yes
|
||||||
|
dbfilename dump.rdb
|
||||||
|
dir /data
|
||||||
|
replica-serve-stale-data yes
|
||||||
|
replica-read-only yes
|
||||||
|
repl-diskless-sync no
|
||||||
|
repl-diskless-sync-delay 5
|
||||||
|
repl-ping-replica-period 10
|
||||||
|
repl-timeout 60
|
||||||
|
repl-disable-tcp-nodelay no
|
||||||
|
replica-priority 100
|
||||||
|
maxmemory-policy allkeys-lru
|
||||||
|
lazyfree-lazy-eviction no
|
||||||
|
lazyfree-lazy-expire no
|
||||||
|
lazyfree-lazy-server-del no
|
||||||
|
replica-lazy-flush no
|
||||||
|
appendonly yes
|
||||||
|
appendfilename "appendonly.aof"
|
||||||
|
appendfsync everysec
|
||||||
|
no-appendfsync-on-rewrite no
|
||||||
|
auto-aof-rewrite-percentage 100
|
||||||
|
auto-aof-rewrite-min-size 64mb
|
||||||
|
aof-load-truncated yes
|
||||||
|
aof-use-rdb-preamble yes
|
||||||
|
EOF
|
||||||
|
fi
|
||||||
|
|
||||||
|
# 解析参数
|
||||||
|
ACTION=${1:-up}
|
||||||
|
|
||||||
|
case $ACTION in
|
||||||
|
up)
|
||||||
|
print_info "启动所有服务..."
|
||||||
|
docker-compose up -d
|
||||||
|
print_info "服务启动完成！"
|
||||||
|
echo ""
|
||||||
|
echo "========================================"
|
||||||
|
echo " 服务访问地址"
|
||||||
|
echo "========================================"
|
||||||
|
echo ""
|
||||||
|
echo "【管理端 - PC浏览器访问】"
|
||||||
|
echo " - Nacos控制台: http://localhost:8848/nacos (admin/admin)"
|
||||||
|
echo " - Swagger文档: http://localhost:8080/swagger-ui.html"
|
||||||
|
echo " - 应用服务: http://localhost:8080"
|
||||||
|
echo " - Nginx网关: http://localhost"
|
||||||
|
echo ""
|
||||||
|
echo "【移动端 - UniApp】"
|
||||||
|
echo " - H5访问: http://localhost:8080/mobile"
|
||||||
|
echo " - 开发调试: cd fund-mobile && npm run dev:h5"
|
||||||
|
echo ""
|
||||||
|
echo "========================================"
|
||||||
|
;;
|
||||||
|
down)
|
||||||
|
print_info "停止所有服务..."
|
||||||
|
docker-compose down
|
||||||
|
print_info "服务已停止"
|
||||||
|
;;
|
||||||
|
restart)
|
||||||
|
print_info "重启服务..."
|
||||||
|
docker-compose restart
|
||||||
|
print_info "服务重启完成"
|
||||||
|
;;
|
||||||
|
build)
|
||||||
|
print_info "重新构建镜像..."
|
||||||
|
docker-compose build --no-cache
|
||||||
|
print_info "镜像构建完成"
|
||||||
|
;;
|
||||||
|
logs)
|
||||||
|
SERVICE=${2:-}
|
||||||
|
if [ -z "$SERVICE" ]; then
|
||||||
|
docker-compose logs -f
|
||||||
|
else
|
||||||
|
docker-compose logs -f $SERVICE
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
status)
|
||||||
|
print_info "查看服务状态..."
|
||||||
|
docker-compose ps
|
||||||
|
;;
|
||||||
|
clean)
|
||||||
|
print_warn "清理所有数据（包括数据库）..."
|
||||||
|
read -p "确定要删除所有数据吗？这将删除数据库和日志！ [y/N] " confirm
|
||||||
|
if [[ $confirm == [yY] ]]; then
|
||||||
|
docker-compose down -v
|
||||||
|
rm -rf logs/*
|
||||||
|
print_info "数据清理完成"
|
||||||
|
else
|
||||||
|
print_info "取消清理"
|
||||||
|
fi
|
||||||
|
;;
|
||||||
|
mobile)
|
||||||
|
print_info "构建移动端应用..."
|
||||||
|
cd ../../fund-mobile
|
||||||
|
|
||||||
|
case ${2:-h5} in
|
||||||
|
h5)
|
||||||
|
print_info "构建H5版本..."
|
||||||
|
npm run build:h5
|
||||||
|
print_info "H5构建完成，输出目录: dist/build/h5"
|
||||||
|
;;
|
||||||
|
mp-weixin)
|
||||||
|
print_info "构建微信小程序..."
|
||||||
|
npm run build:mp-weixin
|
||||||
|
print_info "微信小程序构建完成，输出目录: dist/build/mp-weixin"
|
||||||
|
print_info "请使用微信开发者工具导入该目录"
|
||||||
|
;;
|
||||||
|
app)
|
||||||
|
print_info "构建App..."
|
||||||
|
npm run build:app
|
||||||
|
print_info "App构建完成，输出目录: dist/build/app"
|
||||||
|
;;
|
||||||
|
dev)
|
||||||
|
print_info "启动移动端开发服务器..."
|
||||||
|
npm run dev:h5
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
echo "用法: $0 mobile {h5|mp-weixin|app|dev}"
|
||||||
|
echo ""
|
||||||
|
echo "命令说明:"
|
||||||
|
echo " h5 - 构建H5版本"
|
||||||
|
echo " mp-weixin - 构建微信小程序"
|
||||||
|
echo " app - 构建App"
|
||||||
|
echo " dev - 启动开发服务器"
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
echo "用法: $0 {up|down|restart|build|logs|status|clean|mobile}"
|
||||||
|
echo ""
|
||||||
|
echo "命令说明:"
|
||||||
|
echo " up - 启动所有服务"
|
||||||
|
echo " down - 停止所有服务"
|
||||||
|
echo " restart - 重启服务"
|
||||||
|
echo " build - 重新构建镜像"
|
||||||
|
echo " logs - 查看日志 [服务名]"
|
||||||
|
echo " status - 查看服务状态"
|
||||||
|
echo " clean - 清理所有数据（危险！）"
|
||||||
|
echo " mobile - 移动端构建 {h5|mp-weixin|app|dev}"
|
||||||
|
exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "========================================"
|
||||||
|
echo " 部署脚本执行完成"
|
||||||
|
echo "========================================"
|
||||||
Loading…
x
Reference in New Issue
Block a user