mapannai-plus/env.example at master · RicterZ/mapannai-plus · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
# 复制为 .env 并填写实际值。地图和地点服务分别选择，可自由组合。
# 修改服务端变量后重启/重新部署；NEXT_PUBLIC_* 变量需在构建前设置。

# ── 地图渲染 ─────────────────────────────────────────────
# osm：MapLibre + OpenStreetMap（默认）
# amap：高德地图官方 JS API 2.0
MAP_RENDERER=osm

# 仅 MAP_RENDERER=amap 时必填：高德控制台申请「Web端(JS API)」Key。
# 安全密钥与这个 JS Key 配套，不是下面的 Web 服务 Key。
# 在高德控制台配置自己的部署域名白名单。
# 当前实现将 JS Key 和安全密钥下发浏览器，用于 _AMapSecurityConfig。
AMAP_JS_KEY=
AMAP_JS_SECURITY_CODE=

# 仅 osm 使用：true（默认）走同源 /osm-tiles/{z}/{x}/{y}.png，
# 需 nginx/CDN 配置代理 https://tile.openstreetmap.org/。
# false：浏览器直接访问 OSM 官方瓦片，无需反代；本地无代理时使用此值。
# 构建时生效。当前 Docker 未透传此构建参数，Compose 部署默认需配置瓦片反代。
NEXT_PUBLIC_OSM_TILE_PROXY=true

# ── 地点服务（与地图渲染引擎独立）─────────────────────────
# 三项各自支持 google | amap，默认 google；网页与 MCP 共用这些默认值。
# 高德地点服务适合中国；海外地点请选择 google。
MAP_SEARCH_PROVIDER=google
MAP_DETAILS_PROVIDER=google
MAP_DIRECTIONS_PROVIDER=google

# 任一服务选 google 时需要 Google API Key。
# 在 Google 控制台启用 Places API、Geocoding API、Directions API（按所用能力）。
# BASE_URL 可改为你的 Google API 反向代理地址；通常保留默认值。
GOOGLE_API_KEY=
GOOGLE_API_BASE_URL=https://maps.googleapis.com

# 任一服务选 amap 时需要高德控制台申请的「Web服务」Key。
# 不要填 AMAP_JS_KEY：JS 地图和后端 Web 服务使用两种不同类型的 Key。
AMAP_API_KEY=
AMAP_API_BASE_URL=https://restapi.amap.com

# 全部使用高德的示例：修改以上四个选择值并填三个高德凭据即可。
# MAP_RENDERER=amap
# MAP_SEARCH_PROVIDER=amap
# MAP_DETAILS_PROVIDER=amap
# MAP_DIRECTIONS_PROVIDER=amap
# AMAP_JS_KEY=你的Web端JS_API_Key
# AMAP_JS_SECURITY_CODE=对应安全密钥
# AMAP_API_KEY=你的Web服务Key

# ── 数据存储与访问认证 ───────────────────────────────────
# SQLite 默认 ./data/mapannai.db；Compose 将 /app/data 持久化到命名卷。
# 自定义路径需位于持久化挂载目录内，数据库同时保存地点、旅行与路线缓存。
# SQLITE_PATH=/data/mapannai.db

# 留空不启用 API 认证；配置后前端弹窗输入同一个 token。
# MCP 使用 Authorization: Bearer <token>，或 x-api-token: <token>。
API_TOKEN=

# ── 网页 AI 对话（可选）───────────────────────────────────
# API 地址、Key、模型在网页“AI 规划”中配置，聊天记录保存在用户浏览器。
# 服务端默认仅允许公共 HTTPS AI API，阻止私有地址并且不跟随重定向。
# 自托管模型需要私有网络或 HTTP 时由部署者显式启用；地址需从服务端可达。
# Docker 中 localhost 指容器自身。开启后建议配置上面的 API_TOKEN 限制访问。
AI_ALLOW_PRIVATE_ENDPOINTS=false

# ── 腾讯云 COS（可选，用于图片上传）───────────────────────
TENCENT_COS_SECRET_ID=
TENCENT_COS_SECRET_KEY=
TENCENT_COS_REGION=ap-chongqing
TENCENT_COS_BUCKET=
# 构建时设置，多个图片域名用英文逗号分隔，仅填域名不含协议。
# NEXT_PUBLIC_IMAGE_DOMAINS=your-bucket.cos.ap-chongqing.myqcloud.com