免费开源的 Typesense 管理面板 typesense-dashboard：一站式可视化管控搜索引擎的完整指南

免费开源的 Typesense 管理面板 typesense-dashboard一站式可视化管控搜索引擎的完整指南【免费下载链接】typesense-dashboardA Typesense Dashboard to manage and browse collections.项目地址: https://gitcode.com/gh_mirrors/ty/typesense-dashboardtypesense-dashboard 是一款免费开源的 Typesense 管理面板让管理员通过浏览器或桌面端就能可视化地管理 Typesense 搜索引擎查看服务器状态、创建和编辑集合Collection、导入导出文档、调试验证搜索效果、管理同义词与 API Key无需手写任何 API 请求。 typesense-dashboard 是什么Typesense 是一个轻量级、高性能的开源搜索引擎但官方只提供 API 和命令行缺少一个开箱即用的图形化控制台。typesense-dashboard 正是为此而生三种运行形态Web 应用、Docker 自托管、Electron 桌面应用覆盖全链路服务器状态 → 集合 → 文档 → 搜索 → 同义词/策展Curation→ API Key部署极简一条 Docker 命令即可上线完全免费开源代码结构清晰基于 Vue 3 Quasar TypeScript 构建项目所有页面入口都定义在 src/router/routes.ts 中共 15 个功能页面覆盖 Typesense 日常运维的绝大多数场景。 Typesense 管理面板的 3 种快速部署方法方法一Docker 一键部署推荐生产环境项目内置 Dockerfile构建过程会自动完成前端打包并用 Caddy 托管静态文件docker build -t typesense-dashboard . docker run -d -p 80:80 typesense-dashboard 如需将面板挂载到子路径如/example添加构建参数--build-argPUBLIC_PATH/example即可。注意Web 版通过浏览器直接请求你的 Typesense 服务因此服务端需要以--enable-cors参数启动否则会跨域报错。方法二本地源码开发适合二次开发git clone https://gitcode.com/gh_mirrors/ty/typesense-dashboard cd typesense-dashboard npm ci npm run dev开发时如果遇到跨域问题可设置环境变量DEV_API_PROXY_TARGET指向远程 Typesense 服务开发服务器会自动代理/api请求详见 README.md 的 Development 章节。方法三桌面应用适合大数据量导入导出桌面版基于 Electron源码见 src-electron/electron-main.ts最大优势是除即时搜索外不受 CORS 限制导入/导出大文件JSON / JSONL不会像浏览器那样超时项目还贴心地提供了 typesense-test-server/docker-compose.yml一条命令拉起多个版本的 Typesense 测试实例含 3 节点集群方便开发调试。️ 功能全景一站式管控搜索引擎的 12 大模块1️⃣ 服务器状态监控登录后首页即是服务器仪表盘CPU 逐核占用、系统内存/磁盘水位、Typesense 内部内存指标、请求延迟统计一眼掌握引擎健康度。2️⃣ 集合Collection可视化管理集合列表页展示每个集合的文档数、Schema 字段数、内存分片数并支持一键IMPORT / EXPORT。新建集合时支持表单模式和JSON 模式切换在表单里逐个添加字段并勾选optional / facet / index零 JSON 基础也能建集合。3️⃣ 文档编辑与 Schema 查看文档页内置 Monaco 编辑器与 VS Code 同款支持批量粘贴 JSON 数组并通过Action mode切换 upsert / create / updateSchema 页以只读视图展示集合的完整字段定义便于随时核对字段类型与索引配置4️⃣ 搜索调试验证双模式这是管理面板最好用的功能之一提供两种搜索模式InstantSearch 模式左侧是 facet 筛选栏按作者、年份等聚合过滤右侧是搜索结果卡片支持分页体验如同一个现成的搜索页面JSON 模式直接编写/编辑搜索请求 JSON运行后在下方查看高亮结果并可一键导出 hits 或原始结果。5️⃣ 同义词、策展Curation与别名Synonyms管理多向/单向同义词组如 apple ↔ android提升召回率Curations为特定查询固定结果排序例如把指定文档 ID 强制排到前两位Aliases给集合配置别名如books_prod→books3实现无缝的蓝绿切换。6️⃣ API Key 权限管理在页面中直接创建、编辑、吊销 API Key提供 Admin / Search 两类示例模板可按集合、按操作精细授权7️⃣ 集群状态多节点并行体检当连接的节点属于集群时导航栏会额外出现Cluster Status页面将同一clusterTag标记的多个节点并排展示并行轮询状态节点卡片显示角色Leader/Follower 高亮、内存与磁盘占用、网络收发速率点击卡片可直接切换到对应节点给服务器历史条目打标签clusterTag即可分组这是运维多节点 Typesense 集群的利器。⚙️ 进阶配置config.json 实现免登录与集群分组面板启动时会读取/config.json项目根目录提供了样例 config.json.sample主要能力配置项作用apiKeynode写入后自动登录无需每次填地址和密钥见 config.json.autologinhistory预置服务器书签登录页一键切换环境clusterTag将历史条目归入集群激活 Cluster Status 页面ui.hideProjectInfo隐藏导航栏中的项目信息区块两种注入方式Docker 环境由 entrypoint.sh 处理# 方式一挂载配置文件 docker run -d -p 80:80 -v /path/to/config.json:/srv/config.json typesense-dashboard # 方式二base64 环境变量 docker run -d -p 80:80 -e TYPESENSE_DASHBOARD_CONFIG$(base64 -w 0 /path/to/config.json) typesense-dashboard 小贴士如果把面板和 Typesense 反代到同一个域名下可以把node.host设为SAME面板会自动解析当前访问的主机、协议和端口配置更干净。 项目核心文件速览文件说明README.md完整使用文档与部署说明src/pages/15 个功能页面服务器状态、集合、搜索、同义词等src/shared/api.tsTypesense API 封装层src-electron/Electron 桌面端主进程与预加载脚本typesense-test-server/多版本 集群测试环境 compose 文件 已知限制与常见问题Web 版需要 CORSTypesense 服务端必须加--enable-cors启动参数HTTPS 页面还要求后端同样走 SSL否则浏览器会报 Mixed Content 错误大文件导入导出请用桌面版浏览器版处理大 JSON/JSONL 会超时暂未实现的 API 功能创建快照Snapshot、按查询删除delete by query、Scoped Search Key 生成计划中 总结如果你正在使用 Typesensetypesense-dashboard 值得放进你的运维工具箱✅ 一条 Docker 命令部署零成本获得图形化控制台✅ 集合、文档、搜索、同义词、API Key 全链路可视化管理✅ 集群状态页多节点并排体检运维省心✅ 免费开源支持 Docker / Web / 桌面三种形态从今天起用这个 Typesense 管理面板把繁琐的 API 调试变成点点鼠标的事吧【免费下载链接】typesense-dashboardA Typesense Dashboard to manage and browse collections.项目地址: https://gitcode.com/gh_mirrors/ty/typesense-dashboard创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考