Hister Docker部署实战：从compose.yml到反代的一站式教程

Hister Docker部署实战从compose.yml到反代的一站式教程【免费下载链接】histerYour own search engine项目地址: https://gitcode.com/GitHub_Trending/hi/histerHister 是一款自托管的个人搜索引擎而Hister Docker部署是新手上手最快、最省心的方式一个容器、一条命令几分钟就能拥有属于你自己的私密搜索引擎。本教程将带你走完从拉取 compose.yml 到配置反向代理的完整流程全程无需写一行代码。为什么选择 Docker 部署 Hister与传统二进制安装相比Docker 部署 Hister 有明显优势开箱即用官方镜像已内置 Web 前端、yt-dlp等依赖docker compose up即可运行环境干净不污染系统目录升级时只需换镜像版本架构通用官方镜像同时支持 AMD64 和 ARM64树莓派也能跑安全加固默认以非 root 用户UID 65532运行镜像内置健康检查每 30 秒探测/health端点镜像构建细节可以见 Dockerfile——它采用多阶段构建先编译前端和 Go 二进制再打包进极小的 Alpine 运行时最终镜像非常轻量。第一步获取 Hister Docker Compose 文件克隆仓库仓库自带一份生产级的 compose.ymlgit clone https://gitcode.com/GitHub_Trending/hi/hister cd hister仓库中的 compose.yml 已经配置好了安全选项只读文件系统、禁用特权提升、丢弃全部 capabilities拿来即用。你也可以在 docker 官方文档 中找到更精简的手写版本。第二步一条命令启动 Hister 容器在项目根目录执行docker compose up -d启动后用下面这条命令确认容器健康状态docker compose ps # 看到 healthy 即表示成功然后打开浏览器访问http://localhost:4433就能看到 Hister 的 Web 搜索界面 端口 4433 是 Hister 的默认服务端口。如果该端口被占用修改 compose.yml 中ports的左侧映射值如8080:4433并同步调整环境变量HISTER__SERVER__ADDRESS的端口号。compose.yml 关键配置项速览配置项作用image: ghcr.io/asciimoo/hister:latest官方镜像AMD64/ARM64 通用volumes: hister_data:/hister/data命名卷持久化索引数据与配置HISTER__SERVER__ADDRESS监听地址0.0.0.0表示允许外部访问HISTER__SERVER__BASE_URL客户端连接用的地址反代场景必须改成公网域名restart: unless-stopped异常退出自动重启容器内配置完全靠环境变量完成双下划线__对应配置层级这是 Docker 部署 Hister 的推荐做法无需挂载或编辑配置文件。第三步按场景选择网络模式场景一仅本机使用最简单保持默认配置即可访问http://localhost:4433。场景二局域网设备访问将base_url改为主机的内网 IP示例假设主机 IP 为192.168.1.100environment: - HISTER__SERVER__ADDRESS0.0.0.0:4433 - HISTER__SERVER__BASE_URLhttp://192.168.1.100:4433之后手机、平板在同一局域网内都能连接这个地址进行索引和搜索。场景三公网部署 反向代理推荐Hister 服务本身不提供 HTTPS暴露在公网时必须搭配反向代理。做法分两步将base_url设为你的公网域名并让服务只监听本地回环地址environment: - HISTER__SERVER__ADDRESS127.0.0.1:4433 - HISTER__SERVER__BASE_URLhttps://hister.example.com用 Caddy 或 Nginx 终结 TLS。以 Caddy 为例它会自动申请并续期证书只需几行hister.example.com { reverse_proxy localhost:4433 }如果你用 Nginx除了常规 TLS 配置外还有两个容易踩坑的点完整配置参考 server-setup 文档/search端点使用 WebSocket必须正确转发Upgrade/Connection头否则搜索功能会失效部分页面较大需将client_max_body_size调大建议 100m否则会出现 413 错误 安全提示Hister 会传输完整的浏览记录及页面内容公网部署务必走 HTTPS建议同时配置access_token保护 API 写入权限多用户场景可开启user_handling模式详见 configuration 文档。数据持久化与备份策略所有索引数据、规则、密钥都存放在/hister/data由 compose.yml 中的命名卷hister_data托管升级镜像不会丢数据# 查看卷位置 docker volume ls | grep hister_data如果你希望数据落在主机目录便于 rsync 备份先修正属主再改挂载mkdir -p ./data sudo chown 65532:65532 ./datavolumes: - ./data:/hister/data开启了 SELinux 的机器记得给挂载路径加上:Z后缀。常见问题排查症状排查方向服务起不来检查 4433 端口是否被占用docker compose logs hister查看日志页面能打开但样式错乱base_url配置不正确修正后重启容器浏览器扩展连不上扩展里填的服务地址必须与base_url完全一致内存占用偏高配置中关闭detect_languages之后执行hister reindex重建索引更多细节可查阅 troubleshooting 文档。部署完成开始使用看到healthy状态、打开 Web 界面能正常搜索你的私有搜索引擎就上线了。接下来建议安装浏览器扩展Chrome / Firefox新访问的页面将自动进入索引用import命令导入已有浏览器历史、书签或本地文件在 Web 界面配置忽略规则、关键词别名让搜索更精准祝部署顺利 【免费下载链接】histerYour own search engine项目地址: https://gitcode.com/GitHub_Trending/hi/hister创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考