typesense-dashboard 配置全解config.json 自动登录、多服务器书签与集群标签一文讲透【免费下载链接】typesense-dashboardA Typesense Dashboard to manage and browse collections.项目地址: https://gitcode.com/gh_mirrors/ty/typesense-dashboardtypesense-dashboard 是一款免费开源的 Typesense 搜索引擎管理面板可视化浏览 Collection、搜索调试和集群状态。而 config.json 是它唯一的核心配置文件写好这一个文件就能实现打开即自动登录、多服务器书签一键切换、集群节点分组监控。本文带你逐个字段讲透它的配置技巧。为什么 config.json 这么重要面板启动时会尝试从根目录读取config.json见 checkAutoLoginConfig.ts根据内容完成三件事自动登录配置了apiKey和node时打开页面直接连上服务器无需手输预填书签history数组会合并进浏览器本地的服务器历史记录充当书签界面定制ui段可隐藏页脚的项目信息等。项目根目录提供了两个现成模板照着抄即可config.json.sample完整示例自动登录 3 个书签 集群标签config.json.autologin最简自动登录示例。核心字段逐项拆解服务器连接参数 nodenode对象决定连到哪台 Typesense 节点共 5 个字段字段说明示例host服务器地址localhostport端口字符串8108protocol协议http/httpspath反向代理路径前缀/apitls是否 HTTPSfalse自动登录apiKey 一行搞定顶层apiKey与node搭配使用面板加载后会自动执行登录并发起连接检测checkAutoLoginConfig.ts。想跳过手输登录页只需要这三行{ apiKey: 你的API密钥, node: { host: localhost, port: 8108, protocol: http, path: , tls: false } }⚠️ 提示apiKey是服务器密钥仅建议在内网或受控环境使用此功能公开部署请删掉该字段保留手动登录。SAME 主机模式反向代理同域最佳拍档Web 版有个隐藏技巧把node.host写成SAME面板会自动解析当前访问域名、协议和端口作为服务器地址checkAutoLoginConfig.ts。当你用 Nginx/Caddy 把 Typesense 和面板挂在同一域名下的不同路径时只需{ node: { host: SAME, path: /api } }换域名、换端口都无需改配置是运维场景下最省心的写法。连接超时 connectionTimeoutSeconds慢网络下连接频繁超时加上顶层字段connectionTimeoutSeconds: 10即可调整超时秒数该值会随书签一起保存并生效node.ts。多服务器书签history 数组history是书签列表每项结构与顶层相同nodeapiKey。启动时这些条目会去重合并进浏览器的服务器历史checkAutoLoginConfig.ts之后在左上角菜单的Server History弹窗里点一下就能秒切环境典型用法是给开发、测试、生产各存一条记录团队成员共用同一份config.json即可拥有完全一致的书签。书签列表还支持显示 API Key 前缀同一台服务器存了多个 Key 时会显示key: xxx…前缀帮助区分ServerHistory.vue手动增删登录后自动记录历史也可在弹窗中 Clear history 一键清空。集群标签 clusterTag一键监控整组节点Typesense 集群通常有 Leader 和多个 Follower。给书签条目加上clusterTag: prod-cluster所有相同标签的节点会被识别为同一个集群node.ts。集群状态页 Cluster Status当前连接的节点带有标签时导航栏会出现 Cluster Status 入口ClusterStatus.vue页面内所有同标签节点并排展示节点 URL、版本、Leader/Follower 角色高亮内存、磁盘占用、网络收发、Typesense 指标当前节点高亮点击任意卡片即可切换过去。节点按 host → port → protocol 稳定排序巡检集群时一目了然。在界面上打标签不想改配置文件在 Server History 弹窗里点条目右侧的 ✏️ 编辑按钮输入标签后保存即可。输入框支持自动补全已有标签也能新建还可以删除标签或整条书签ServerHistory.vue。 没打标签的书签不属于任何集群也就不会触发集群状态页——这是控制入口显隐的开关。Docker 部署两种加载 config.json 的方式自托管面板时entrypoint.sh 会在启动时处理配置镜像定义见 Dockerfile方式一挂载文件推荐改配置后重启即生效docker run -d -p 80:80 -v /path/to/config.json:/srv/config.json typesense-dashboard方式二环境变量适合容器编排配置即代码docker run -d -p 80:80 -e TYPESENSE_DASHBOARD_CONFIG$(base64 -w 0 /path/to/config.json) typesense-dashboard启动脚本会自动把 Base64 解码为/srv/config.json。若面板部署在子路径构建时加--build-argPUBLIC_PATH/example即可。UI 定制与其他小贴士隐藏项目信息ui: { hideProjectInfo: true }可移除导航菜单底部的版本、GitHub 链接等对外信息让面板看起来更像内部工具node.tsHTTPS 混合内容从 https 页面访问 http 的 Typesense 会报 MixedContent 错误请确保协议匹配或使用SAME模式CORS浏览器直连需 Typesense 开启--enable-cors桌面版Electron基本不受 CORS 限制导入导出大文件也推荐用桌面版。总结一分钟回顾需求配置位置关键字段打开即登录顶层apiKeynode同域反向代理node.hostSAME多环境书签顶层数组history集群分组监控书签条目内clusterTag隐藏项目信息ui段hideProjectInfo调整超时顶层或书签条目connectionTimeoutSeconds一份几十行的config.json就能把 typesense-dashboard 从手动登录工具升级为开箱即用的团队级管理控制台。建议先照抄 config.json.sample再按上表按需增删字段。【免费下载链接】typesense-dashboardA Typesense Dashboard to manage and browse collections.项目地址: https://gitcode.com/gh_mirrors/ty/typesense-dashboard创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
