.env.example

# =============================================================================
# Neko Master 环境配置文件
# =============================================================================
# 使用方法:
#   1. 复制本文件为 .env:  cp .env.example .env
#   2. 修改下方的端口号（如果默认端口被占用）
#   3. 启动服务: docker compose up -d
# =============================================================================

# -----------------------------------------------------------------------------
# 端口配置（一般只需要改这里）
# -----------------------------------------------------------------------------
# 如果启动时提示 "端口已被占用"，请修改以下三个端口为其他值
# 例如：改为 8080, 8081, 8082

# Web UI 访问端口 - 浏览器访问的地址 http://localhost:WEB_EXTERNAL_PORT
WEB_EXTERNAL_PORT=3000

# API 端口（可选）- 仅直连/调试时需要
# 若仅通过 Nginx 反代 Web，前端会走 /api，无需对外开放 3001
API_EXTERNAL_PORT=3001

# WebSocket 端口（可选）- 实时数据推送
# 如需通过域名使用 WS，可在 Nginx 配置 /ws 代理并设置 WS_URL
WS_EXTERNAL_PORT=3002

# 说明：
# 只有当你需要“直连 API/WS”时才需要改这些外部端口。
# 一般不需要修改容器内部端口（WEB_PORT/API_PORT/COLLECTOR_WS_PORT）。

# -----------------------------------------------------------------------------
# 安全配置
# -----------------------------------------------------------------------------
# Cookie 签名密钥（生产环境必填，建议 32 位以上随机字符串）
# 可使用 openssl rand -hex 32 生成
# COOKIE_SECRET=

# -----------------------------------------------------------------------------
# IP 地理查询配置（可选）
# -----------------------------------------------------------------------------
# 可选值：online / local
# online: 使用线上接口（默认）
# local:  使用本地 MMDB 文件查询
# GEOIP_LOOKUP_PROVIDER=online

# 线上 IP 查询接口地址（仅支持与默认 ipinfo.my 响应结构兼容的服务）
# 非兼容接口可能导致查询失败或字段为空
# GEOIP_ONLINE_API_URL=https://api.ipinfo.es/ipinfo

# -----------------------------------------------------------------------------
# 高级配置（一般不需要修改）
# -----------------------------------------------------------------------------
# 内部端口（容器内使用，除非你知道自己在做什么，否则不要改）
# WEB_PORT=3000
# API_PORT=3001
# COLLECTOR_WS_PORT=3002

# 数据库路径
# DB_PATH=/app/data/stats.db

# 运行环境
# NODE_ENV=production

# -----------------------------------------------------------------------------
# 演示模式配置
# -----------------------------------------------------------------------------
# 设置为 true 启用演示模式（禁止修改后端配置、认证设置和数据操作）
# 用于将在线站点转换为演示站点供公众访问
# SHOWCASE_SITE_MODE=false

# =============================================================================
# 配置完成后，请使用以下命令启动:
#   docker compose up -d
#
# 然后访问: http://localhost:WEB_EXTERNAL_PORT
#   例如: http://localhost:3000
# =============================================================================