RomanNum3ral
/
MicroFish
mirror of https://github.com/666ghj/MiroFish.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Document local deployment constraints

This commit is contained in:
user 2026-04-22 17:16:57 +08:00
parent d0a65067b4
commit 01fcab768e
2 changed files with 8 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
README-ZH.md
View File

@ -298,6 +298,8 @@ LOCAL_ZEP_RERANK_TOP_K=50
### Tailscale 访问 ### Tailscale 访问
发布说明：Tailscale 支持主要面向源码/开发部署，即后端和 Vite 代理运行在同一台主机上。它不会自动公开本地 LLM、embedding 或 reranker 端点；除非你明确需要暴露，否则建议这些模型端点继续绑定在 `127.0.0.1`。
前端现在默认走同源 `/api`，不再默认写死 `http://localhost:5001`。因此你从另一台 Tailscale 设备访问 Vite 开发服务器时，前端请求会继续命中宿主机后端，而不会错误地访问调用方自己的 localhost。 前端现在默认走同源 `/api`，不再默认写死 `http://localhost:5001`。因此你从另一台 Tailscale 设备访问 Vite 开发服务器时，前端请求会继续命中宿主机后端，而不会错误地访问调用方自己的 localhost。
建议在项目根目录 `.env` 中加入： 建议在项目根目录 `.env` 中加入：
@ -320,6 +322,8 @@ FLASK_PORT=5001
### 二、Docker 部署 ### 二、Docker 部署
发布限制：Docker 部署属于旧路径，目前未针对本地 Zep 替代、外部 vLLM/llama.cpp 端点、以及拆分的 Python 3.11 OASIS 运行时做完整验证。需要本地优先工作流时，请使用源码部署。
```bash ```bash
# 1. 配置环境变量（同源码部署） # 1. 配置环境变量（同源码部署）
cp .env.example .env cp .env.example .env

4
README.md
View File

@ -298,6 +298,8 @@ Parameter rules:
### Tailscale Access ### Tailscale Access
Release note: Tailscale support is intended for source-code/dev deployments where the backend and Vite proxy run on the same host. It does not make the local LLM, embedding, or reranker endpoints public by itself; keep those endpoints bound to `127.0.0.1` unless you intentionally expose them.
The frontend now defaults to same-origin `/api` instead of `http://localhost:5001`, so opening the Vite dev server from another device over Tailscale will still reach the backend running on the host machine. The frontend now defaults to same-origin `/api` instead of `http://localhost:5001`, so opening the Vite dev server from another device over Tailscale will still reach the backend running on the host machine.
Recommended root `.env` settings: Recommended root `.env` settings:
@ -320,6 +322,8 @@ If you expose the backend through `tailscale serve` or `tailscale funnel`, set `
### Option 2: Docker Deployment ### Option 2: Docker Deployment
Release constraint: Docker deployment is legacy/not validated for the local Zep replacement, external vLLM/llama.cpp endpoints, and split Python 3.11 OASIS runtime. Use source deployment for the tested local-first workflow.
```bash ```bash
# 1. Configure environment variables (same as source deployment) # 1. Configure environment variables (same as source deployment)
cp .env.example .env cp .env.example .env