使用概览

首次访问

1. 在浏览器打开站点（开发环境一般为 http://localhost:5173，生产为绑定的域名）。
2. 若尚未安装，会进入 「NavHub 初始化」 页面，按向导填写 MySQL 与管理员信息。
3. 安装成功后使用管理员账号登录。

登录后常用功能

• 分类与网站：维护导航分类与站点（名称、URL、图标等）。
• 云端同步：在已登录用户间同步个人导航（以界面为准）。
• 主题配置：背景、配色等。
• 访问统计：具备权限时可见相关入口。
• 管理员：用户管理、全局默认页 / 搜索引擎等。

侧栏支持多种 布局与停靠位置（左/右/顶/底、居中、自定义拖拽等）。

健康检查与 API

• 后端健康检查：http://<主机>:8520/health，应返回 {"status":"ok"}。
• API 统一前缀：/api。
• 接口文档：后端运行时打开 /docs（Swagger）。

常见问题摘要

现象	处理思路
前端能打开，接口 502	确认后端已监听 8520（或自定义端口），反代 /api 指向正确。
数据库连接失败	检查 MySQL 服务、防火墙、用户主机权限、库名密码。
Linux 脚本 $'\r' 错误	sed -i 's/\r$//' setup.sh start.sh

生产环境请修改 SECRET_KEY / JWT Secret，并做好 MySQL 与 instance/app_config.json 备份。