zhibo/环境配置指南.md

环境配置指南

本项目采用分离配置架构：

• 普通业务功能（用户、消息、商城等）→ 可切换本地/远程
• 直播/通话服务 → 始终连接远程服务器

---

一、APP 配置

配置文件位置

android-app/local.properties

配置说明

# ============ 主API地址（普通业务功能）============
# 本地开发时使用本地地址
api.base_url_emulator=http://10.0.2.2:8081/
api.base_url_device=http://192.168.1.164:8081/

# ============ 直播/通话服务地址（始终远程）============
live.server_host=1.15.149.240
live.server_port=8083
turn.server_host=1.15.149.240
turn.server_port=3478

切换环境

本地开发（默认）

api.base_url_emulator=http://10.0.2.2:8081/
api.base_url_device=http://192.168.1.164:8081/

全部连接远程

api.base_url_emulator=http://1.15.149.240:8083/
api.base_url_device=http://1.15.149.240:8083/

修改后需要重新编译

cd android-app
.\gradlew assembleRelease

---

二、前端管理端配置

配置文件位置

• 开发环境：Zhibo/admin/.env.development
• 生产环境：Zhibo/admin/.env.production

开发环境（本地）

ENV = 'development'
VUE_APP_BASE_API = 'http://127.0.0.1:30001'

生产环境（远程）

ENV = 'production'
VUE_APP_BASE_API = ''

生产环境使用空字符串，由Nginx代理到后端

---

三、后端配置

配置文件位置

Zhibo/zhibo-h/crmeb-front/src/main/resources/application.yml

关键配置

server:
  port: 8081  # 本地开发端口

spring:
  datasource:
    url: jdbc:mysql://1.15.149.240:3306/zhibo  # 数据库地址
  redis:
    host: 127.0.0.1  # Redis地址

服务器启动脚本

#!/bin/bash
JAR_PATH="/www/wwwroot/1.15.149.240_30002/Jar"

# Front API (带SRS配置)
nohup java -Xms512m -Xmx1024m -jar ${JAR_PATH}/Crmeb-front.jar \
    --server.port=8083 \
    --spring.redis.host=127.0.0.1 \
    --LIVE_PUBLIC_SRS_HOST=1.15.149.240 \
    --LIVE_PUBLIC_SRS_RTMP_PORT=25002 \
    --LIVE_PUBLIC_SRS_HTTP_PORT=25003 \
    > ${JAR_PATH}/logs/front.log 2>&1 &

---

四、服务架构图

┌─────────────────────────────────────────────────────────────┐
│                    远程服务器 1.15.149.240                    │
├─────────────────────────────────────────────────────────────┤
│  Front API (8083)                                           │
│    ├── WebSocket: /ws/call (通话信令) ←── APP直连            │
│    ├── WebSocket: /ws/live/* (直播弹幕) ←── APP直连          │
│    └── REST API: /api/front/* (可选)                        │
│                                                             │
│  SRS流媒体服务器                                              │
│    ├── RTMP: 25002                                          │
│    └── HTTP-FLV: 25003                                      │
│                                                             │
│  TURN服务器: 3478                                            │
└─────────────────────────────────────────────────────────────┘
                              ▲
          直播/通话服务        │
        ─────────────────────┼─────────────────────
          普通业务功能        │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    本地开发环境                               │
├─────────────────────────────────────────────────────────────┤
│  Front API (8081)                                           │
│    └── REST API: /api/front/* ←── APP连接                   │
│                                                             │
│  Admin API (30001)                                          │
│    └── REST API: /api/admin/* ←── 管理前端连接               │
└─────────────────────────────────────────────────────────────┘

---

五、快速切换命令

APP切换到全远程

编辑 android-app/local.properties：

api.base_url_device=http://1.15.149.240:8083/

APP切换到本地开发

编辑 android-app/local.properties：

api.base_url_device=http://192.168.1.164:8081/

前端切换

# 开发模式（连本地）
npm run dev

# 生产构建（连远程）
npm run build:prod

---

六、端口清单

服务	本地端口	远程端口	说明
Front API	8081	8083	APP主API
Admin API	30001	30003	管理后台API
SRS RTMP	-	25002	直播推流
SRS HTTP	-	25003	直播播放
TURN	-	3478	视频通话中继
MySQL	-	3306	数据库
Redis	6379	6379	缓存