Whoogle-Search 私有化部署3 条路线让自托管隐私搜索引擎跑起来【免费下载链接】whoogle-searchA self-hosted, ad-free, privacy-respecting metasearch engine项目地址: https://gitcode.com/GitHub_Trending/wh/whoogle-search每次打开搜索框广告排在结果前面点开的链接还带着追踪参数——这是现在多数人的搜索日常。Whoogle-Search 是一个自托管的元搜索引擎它不建自己的索引而是替你向 Google 要结果再把广告、JavaScript、AMP 链接、Cookie 和 IP 追踪全部过滤掉交还一个干净的结果页。说白了就是部署在你自己机器上的一台隐私搜索前端无广告、不留你的痕迹。自托管指服务跑在你掌控的硬件上元搜索引擎指结果仍来自 Google只是你不直连 Google中间隔了一层清洗。你看到的搜索结果和直接搜谷歌是同一批只是路径干净了。开工之前把要求核对一遍Whoogle 很轻低配机器就能跑项目最低要求推荐CPU1 核2 核内存256MB512MB 以上磁盘约 100MB1GB 以上软件DockerCompose或 Python 3.7Docker端口默认 5000防火墙放行 5000/tcp唯一要提前确认的是机器本身能访问 Google。网络直连不通的话后面部署得再漂亮也拿不到结果这是整个隐私搜索方案的前提。选一条部署路线Docker、Compose 还是 Python三条路线各有取舍按你的情况挑路线适合谁难度后续维护Docker 单容器快速验证、个人自用低低Docker Compose要改配置、挂 HTTPS、长期跑中中Python 直接运行没有 Docker、想改源码高高建议先跑 Docker 单命令够用就不必折腾打算挂域名、加认证直接上 Compose想读代码做魔改再考虑 Python 路线。路线一推荐Docker 部署一条命令跑通先确认 Docker 可用docker --version docker-compose --version然后拉镜像、起容器docker pull benbusby/whoogle-search docker run --publish 5000:5000 --detach --name whoogle-search benbusby/whoogle-search:latest浏览器打开 http://localhost:5000看到搜索框就算完成了无广告搜索引擎搭建的第一步。--publish左边是主机端口、右边是容器端口想换端口只改左边那个数字。路线二Docker Compose方便日后加配置长期使用建议 Compose。克隆仓库并启动git clone https://gitcode.com/GitHub_Trending/wh/whoogle-search cd whoogle-search docker-compose up -d仓库自带的 docker-compose.yml 已经配好内存上限256MB、非特权用户、重启策略不用自己写。想加功能时改动environment段即可比如启用基础认证environment: - WHOOGLE_USERyour_username - WHOOGLE_PASSyour_password其余变量——代理、站点替代地址等——在模板文件 whoogle.template.env 里都能查到名字。路线三Python 直接运行最灵活适合没有 Docker 的环境。以 Ubuntu/Debian 为例先装系统依赖sudo apt-get install -y python3 python3-venv python3-pip libcurl4-openssl-dev libssl-dev再建虚拟环境并安装git clone https://gitcode.com/GitHub_Trending/wh/whoogle-search cd whoogle-search python3 -m venv venv source venv/bin/activate pip install -r requirements.txt ./runrequirements.txt 里有少数包需要本机编译如 cryptography卡在 gcc 报错时先补上工具链sudo apt-get install -y build-essential。换端口则用./run --port 8080。避坑手册先看现象再动手部署后撞到的问题基本集中在三处出现时照下面对 现象一5000 端口被占用现象容器起不来报错Bind for 0.0.0.0:5000 failed: port is already allocated。原因机器上别的程序先占了 5000。处理不用争直接改主机端映射docker run --publish 8080:5000 --detach --name whoogle-search benbusby/whoogle-search:latestCompose 用户改 docker-compose.yml 里ports的左侧数字即可容器内端口不动。现象二容器在跑浏览器却打不开现象docker ps里容器状态正常远程浏览器访问 http://服务器IP:5000 一直转圈。原因绝大多数情况是防火墙。处理放行端口# Ubuntu/Debian sudo ufw allow 5000/tcp # CentOS/RHEL sudo firewall-cmd --add-port5000/tcp --permanent sudo firewall-cmd --reload现象三容器过一会儿自己停了现象容器从 running 变成 exited。原因资源不够或配置有误。容器不会主动说明死因日志会。处理先看日志再判断docker logs whoogle-searchPython 部署的可以看journalctl -u whooglesystemd 托管时。修完顺手做个健康检查curl -I http://localhost:5000看到HTTP/1.1 200 OK就是活着的。进阶选项HTTPS、Tor、开机自启基础功能跑通后想再舒服一点按场景挑挂上域名加 HTTPSTraefik想让 https 访问仓库里有一份现成的 docker-compose-traefik.yamlTraefik 和 Lets Encrypt 自动续签都配好了。用前改两处changedomain.name换成你的邮箱、change.host.name换成你的域名然后docker-compose -f docker-compose-traefik.yaml up -d走 Tor让查询不直接暴露本机 IP想达到的效果向 Google 发出的请求经 Tor 中转本机 IP 不出现在 Google 侧。怎么配Docker 部署加一个环境变量WHOOGLE_CONFIG_TOR1Compose 的environment里加镜像内置 Tor 服务随容器一起启动。Python 部署宿主机要自己跑 Tor。仓库带了一份 Tor 配置示例已启用ControlPort 9051和 cookie 认证和启动脚本配好后同样设WHOOGLE_CONFIG_TOR1让 Whoogle 接入。systemd 开机自启 基础认证想达到的效果服务器重启后服务自动恢复Python 部署场景。怎么配把下面的单元文件写入/etc/systemd/system/whoogle.service替换其中的用户名和路径[Unit] DescriptionWhoogle Search Afternetwork.target [Service] Typesimple Useryour_username WorkingDirectory/path/to/whoogle-search ExecStart/path/to/whoogle-search/run --host 127.0.0.1 --port 5000 Restartalways RestartSec3 [Install] WantedBymulti-user.target然后启用sudo systemctl daemon-reload sudo systemctl enable whoogle sudo systemctl start whoogleDocker 用户不需要这一步docker-compose.yml 里的restart: unless-stopped已经覆盖重启场景。再配上前面提到的基础认证两个变量这个隐私搜索入口就可以放心暴露给常用设备了。长期维护更新与日志长期跑两件事定期更新。上游迭代很快也包含安全修复。Compose 部署最省事docker-compose pull docker-compose up -d纯docker run部署的顺序是docker pull benbusby/whoogle-search接着docker stop whoogle-search docker rm whoogle-search然后重跑第一步的 run 命令。一个要知晓的风险2025 年 1 月起Google 对无 JS 结果页的支持变得不稳而 Whoogle 恰好依赖这类页面做过滤。开发者仍在跟进变通方案留意仓库 README 的更新即可不必现在焦虑。跑起来之后不用改默认搜索引擎也能用如果打算每天用它把 http://localhost:5000 加进浏览器自定义搜索引擎搜索地址格式为http://localhost:5000/search?q%s即可。到这一步一台无广告、不追踪的搜索引擎已经在你自己的机器上跑了。【免费下载链接】whoogle-searchA self-hosted, ad-free, privacy-respecting metasearch engine项目地址: https://gitcode.com/GitHub_Trending/wh/whoogle-search创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Whoogle-Search 私有化部署：3 条路线让自托管隐私搜索引擎跑起来
Whoogle-Search 私有化部署3 条路线让自托管隐私搜索引擎跑起来【免费下载链接】whoogle-searchA self-hosted, ad-free, privacy-respecting metasearch engine项目地址: https://gitcode.com/GitHub_Trending/wh/whoogle-search每次打开搜索框广告排在结果前面点开的链接还带着追踪参数——这是现在多数人的搜索日常。Whoogle-Search 是一个自托管的元搜索引擎它不建自己的索引而是替你向 Google 要结果再把广告、JavaScript、AMP 链接、Cookie 和 IP 追踪全部过滤掉交还一个干净的结果页。说白了就是部署在你自己机器上的一台隐私搜索前端无广告、不留你的痕迹。自托管指服务跑在你掌控的硬件上元搜索引擎指结果仍来自 Google只是你不直连 Google中间隔了一层清洗。你看到的搜索结果和直接搜谷歌是同一批只是路径干净了。开工之前把要求核对一遍Whoogle 很轻低配机器就能跑项目最低要求推荐CPU1 核2 核内存256MB512MB 以上磁盘约 100MB1GB 以上软件DockerCompose或 Python 3.7Docker端口默认 5000防火墙放行 5000/tcp唯一要提前确认的是机器本身能访问 Google。网络直连不通的话后面部署得再漂亮也拿不到结果这是整个隐私搜索方案的前提。选一条部署路线Docker、Compose 还是 Python三条路线各有取舍按你的情况挑路线适合谁难度后续维护Docker 单容器快速验证、个人自用低低Docker Compose要改配置、挂 HTTPS、长期跑中中Python 直接运行没有 Docker、想改源码高高建议先跑 Docker 单命令够用就不必折腾打算挂域名、加认证直接上 Compose想读代码做魔改再考虑 Python 路线。路线一推荐Docker 部署一条命令跑通先确认 Docker 可用docker --version docker-compose --version然后拉镜像、起容器docker pull benbusby/whoogle-search docker run --publish 5000:5000 --detach --name whoogle-search benbusby/whoogle-search:latest浏览器打开 http://localhost:5000看到搜索框就算完成了无广告搜索引擎搭建的第一步。--publish左边是主机端口、右边是容器端口想换端口只改左边那个数字。路线二Docker Compose方便日后加配置长期使用建议 Compose。克隆仓库并启动git clone https://gitcode.com/GitHub_Trending/wh/whoogle-search cd whoogle-search docker-compose up -d仓库自带的 docker-compose.yml 已经配好内存上限256MB、非特权用户、重启策略不用自己写。想加功能时改动environment段即可比如启用基础认证environment: - WHOOGLE_USERyour_username - WHOOGLE_PASSyour_password其余变量——代理、站点替代地址等——在模板文件 whoogle.template.env 里都能查到名字。路线三Python 直接运行最灵活适合没有 Docker 的环境。以 Ubuntu/Debian 为例先装系统依赖sudo apt-get install -y python3 python3-venv python3-pip libcurl4-openssl-dev libssl-dev再建虚拟环境并安装git clone https://gitcode.com/GitHub_Trending/wh/whoogle-search cd whoogle-search python3 -m venv venv source venv/bin/activate pip install -r requirements.txt ./runrequirements.txt 里有少数包需要本机编译如 cryptography卡在 gcc 报错时先补上工具链sudo apt-get install -y build-essential。换端口则用./run --port 8080。避坑手册先看现象再动手部署后撞到的问题基本集中在三处出现时照下面对 现象一5000 端口被占用现象容器起不来报错Bind for 0.0.0.0:5000 failed: port is already allocated。原因机器上别的程序先占了 5000。处理不用争直接改主机端映射docker run --publish 8080:5000 --detach --name whoogle-search benbusby/whoogle-search:latestCompose 用户改 docker-compose.yml 里ports的左侧数字即可容器内端口不动。现象二容器在跑浏览器却打不开现象docker ps里容器状态正常远程浏览器访问 http://服务器IP:5000 一直转圈。原因绝大多数情况是防火墙。处理放行端口# Ubuntu/Debian sudo ufw allow 5000/tcp # CentOS/RHEL sudo firewall-cmd --add-port5000/tcp --permanent sudo firewall-cmd --reload现象三容器过一会儿自己停了现象容器从 running 变成 exited。原因资源不够或配置有误。容器不会主动说明死因日志会。处理先看日志再判断docker logs whoogle-searchPython 部署的可以看journalctl -u whooglesystemd 托管时。修完顺手做个健康检查curl -I http://localhost:5000看到HTTP/1.1 200 OK就是活着的。进阶选项HTTPS、Tor、开机自启基础功能跑通后想再舒服一点按场景挑挂上域名加 HTTPSTraefik想让 https 访问仓库里有一份现成的 docker-compose-traefik.yamlTraefik 和 Lets Encrypt 自动续签都配好了。用前改两处changedomain.name换成你的邮箱、change.host.name换成你的域名然后docker-compose -f docker-compose-traefik.yaml up -d走 Tor让查询不直接暴露本机 IP想达到的效果向 Google 发出的请求经 Tor 中转本机 IP 不出现在 Google 侧。怎么配Docker 部署加一个环境变量WHOOGLE_CONFIG_TOR1Compose 的environment里加镜像内置 Tor 服务随容器一起启动。Python 部署宿主机要自己跑 Tor。仓库带了一份 Tor 配置示例已启用ControlPort 9051和 cookie 认证和启动脚本配好后同样设WHOOGLE_CONFIG_TOR1让 Whoogle 接入。systemd 开机自启 基础认证想达到的效果服务器重启后服务自动恢复Python 部署场景。怎么配把下面的单元文件写入/etc/systemd/system/whoogle.service替换其中的用户名和路径[Unit] DescriptionWhoogle Search Afternetwork.target [Service] Typesimple Useryour_username WorkingDirectory/path/to/whoogle-search ExecStart/path/to/whoogle-search/run --host 127.0.0.1 --port 5000 Restartalways RestartSec3 [Install] WantedBymulti-user.target然后启用sudo systemctl daemon-reload sudo systemctl enable whoogle sudo systemctl start whoogleDocker 用户不需要这一步docker-compose.yml 里的restart: unless-stopped已经覆盖重启场景。再配上前面提到的基础认证两个变量这个隐私搜索入口就可以放心暴露给常用设备了。长期维护更新与日志长期跑两件事定期更新。上游迭代很快也包含安全修复。Compose 部署最省事docker-compose pull docker-compose up -d纯docker run部署的顺序是docker pull benbusby/whoogle-search接着docker stop whoogle-search docker rm whoogle-search然后重跑第一步的 run 命令。一个要知晓的风险2025 年 1 月起Google 对无 JS 结果页的支持变得不稳而 Whoogle 恰好依赖这类页面做过滤。开发者仍在跟进变通方案留意仓库 README 的更新即可不必现在焦虑。跑起来之后不用改默认搜索引擎也能用如果打算每天用它把 http://localhost:5000 加进浏览器自定义搜索引擎搜索地址格式为http://localhost:5000/search?q%s即可。到这一步一台无广告、不追踪的搜索引擎已经在你自己的机器上跑了。【免费下载链接】whoogle-searchA self-hosted, ad-free, privacy-respecting metasearch engine项目地址: https://gitcode.com/GitHub_Trending/wh/whoogle-search创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考