Files
gangyan/本地迁移改动与启动说明.md

5.3 KiB
Raw Blame History

本地迁移:改动说明与各模块启动方法

本文记录从原服务器迁移到本机Docker 数据层在 127.0.0.1,离线镜像目录 /opt/docker-images)后的主要配置改动,以及推荐启动顺序与命令
若路径与机器不一致,请以本仓库在磁盘上的实际目录为准(下文默认:/opt/download/oss_files/gangyan-deploy/gangyan)。


一、改动点汇总

1. Java 后端 chat_web_backend

位置 改动说明
src/main/resources/application.yml spring.profiles.active 默认由 dev 改为 yj,避免默认落到仍带历史痕迹的 dev 配置。
application-yj.yml 文件头注明:数据层走本机 DockerMySQL/Redis 为 127.0.0.1(库名、密码与本地容器一致,如 chat_LLM1234567890 等)。
application-dev.yml Redis127.0.0.1:6379database: 0密码为空MySQL127.0.0.1:3306(取代原 33306)。
application-test.yml serverUrlPrefix、JDBC、Redis 统一为本机,密码与本地 MySQL 对齐。
application-prod.yml serverUrlPrefix 改为本地前端占位(prod 仍为 ENC 加密数据源,一般不用于本机开发)。
.../DocController.java 富文本中历史图片域名 106.3.149.154 / 192.168.56.188 替换为 http://127.0.0.1:8099/chat_web_backend
backend/start_local.sh JVM 参数全部在 -jar 之前;增加 -Djava.net.useSystemProxies=false 等,避免 JDBC 误走系统 SOCKS仅用 profile=yj,数据源以 jar 内 / 源码 application-yj.yml 为准。
chat_web_backend/远程数据库配置说明.md 已改写为纯本地部署说明,并指向 /opt/docker-images
docs/project-deployment-audit-report.md 文首增加说明:表格内公网 IP 为历史审计,以当前 yml 为准
项目启动总结.md编译和启动说明.md登录账号信息.md 远程库表述改为本机 Docker

重要:若部署仍使用已打好旧配置的 chat_web_yj.jarjar 包内 BOOT-INF/classes 可能是旧 yml。修改源码后需在本模块执行 mvn -DskipTests package 重新打 jar再启动。

2. Python RAG langchain-chat

位置 改动说明
server/embeddings_api.py(若已部署该补丁) list_online_embed_models() 优先于 list_embed_models(),避免 bge-m3-api 被误判为本地 HuggingFace。
configs/kb_config.py 默认搜索引擎 duckduckgokgo_*DOWNLOAD_HOST_CKIMAGE_SERVER_URL_TEMPLATE、画图 URL 等改为 127.0.0.1 占位Zilliz 云主机改为 127.0.0.1secure: False(向量库以 Milvus 127.0.0.1:19530 为主)。
server/agent/tools/search_picture.py 旧公网图片地址改为 127.0.0.1:8099/chat_web_backend

说明configs/model_config.py 中 LLM/Embedding 的 http://10.102.24.75:3000 及部分公网 API 属于模型推理服务,与 MySQL/Redis 不同;若需全部收敛到本机,需单独提供本机网关后再改。

3. 基础设施约定

  • MySQL、Redis、Milvus 等通过 Docker 暴露到 127.0.0.1,离线镜像 tar 目录:/opt/docker-images
  • 根目录 /opt/start_all.sh 为聚合示例;其中 Java 行若与当前 jar / 库名不一致,优先使用 backend/start_local.sh

二、各模块启动方法(推荐顺序)

0. 前置Docker 数据层

cd /opt/download/oss_files/gangyan-deploy/gangyan/mysql/mysql-8.4.4
docker compose up -d

docker start redis-server 2>/dev/null || docker run -d --name redis-server -p 6379:6379 redis:7-alpine

cd /opt/download/oss_files/gangyan-deploy/gangyan/milvus
docker compose up -d

自检:docker ps;端口 3306637919530 等可用 ss -tlnp 查看。

1. Java 后端 chat_web_backend

  • 端口8099,上下文 /chat_web_backendProfileyj
sudo bash /opt/download/oss_files/gangyan-deploy/gangyan/backend/start_local.sh
# 日志backend/nohup.out

要求:JDK 11(脚本内 JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64)。

2. Python RAG langchain-chat

  • API7861(见 configs/server_config.py
cd /opt/download/oss_files/gangyan-deploy/gangyan/langchain-chat
export PYTHONPATH="$(pwd):$PYTHONPATH"
nohup /opt/software/miniconda3/envs/langchain-chat/bin/python startup.py -a > /tmp/langchain-chat.log 2>&1 &

3. 前端 chat_web_front

  • 端口3000(常见)
cd /opt/download/oss_files/gangyan-deploy/gangyan/chat_web_front
npm run dev
# 或nohup npm run dev > nohup.out 2>&1 &

4. 一键脚本(可选)

bash /opt/start_all.sh

使用前建议核对脚本内 Java 启动是否与 start_local.sh、当前数据库名一致。


三、健康检查(可选)

curl -s -o /dev/null -w "Java %{http_code}\n"      http://127.0.0.1:8099/chat_web_backend/app/user
curl -s -o /dev/null -w "Langchain %{http_code}\n" http://127.0.0.1:7861/docs
curl -s -o /dev/null -w "Vite %{http_code}\n"      http://127.0.0.1:3000/

维护说明:端口、库名或 profile 变更时,请同步更新本文与 application-yj.yml