源码系统概览
文章正文
HostsCloud 是一款运行在 Windows 系统上的本地 Hosts 文件可视化管理工具源码。
它用 PowerShell 做后台、用网页做操作界面，双击启动脚本就能在浏览器里管理 hosts 记录。
这款工具把原本要靠记事本手工编辑的系统文件，变成了带表格、开关和备份按钮的可视化面板。
源码简介
HostsCloud 的核心是一个 PowerShell 后台脚本 hosts_manager.ps1，负责读写系统 hosts 文件、解析记录、管理本地备份，并处理浏览器发来的接口请求。
前端是一份纯 HTML 页面 index.html，包含完整的界面样式与交互逻辑，不依赖任何前端框架或打包工具。
整个项目只有四个文件：后台脚本、网页界面、说明文档和启动批处理，解压后无需安装第三方运行环境。
Windows 7 及以上系统自带 PowerShell，因此只要机器能跑 PowerShell，就能直接启动这个工具。
它把 hosts 记录的增删改查、批量导入、本地多版本备份、GitHub 与 Gitee 云端同步整合到一个本地网页里。
项目以开源形式发布在 GitHub，作者与维护者为 pxhzaii，仓库当前未标注开源协议（LICENSE），正式商用或二次分发前请先确认授权与版权状态。
对需要频繁切换开发环境、屏蔽广告域名或做本地域名映射的用户来说，它把繁琐的手动编辑变成了几次点击。
适用场景
开发人员在本地调试网站时，经常需要把某个域名指向 127.0.0.1 或内网测试机，用这个工具可以免记事本快速添加和切换。
想屏蔽视频网站广告或某些追踪域名的人，可以把广告域名批量映射到 0.0.0.0，并用备注标明每条规则的作用。
运维或测试人员在多套环境之间来回切换时，本地多版本备份能随时把 hosts 恢复到上一个可用状态。
团队或个人希望把 hosts 配置像代码一样托管到 GitHub、Gitee 时，一键推送和拉取能省去手工拷贝。
这款源码免费下载后适合二次开发，例如接入更多云端平台、增加分组管理或导出导入配置。
功能亮点
可视化记录管理：网页表格逐行展示 IP、域名和备注，每行带编辑、删除按钮，还有启用或禁用开关，修改后立刻自动保存并生效。
批量操作：支持把多行文本一次性粘贴导入，也能全选后批量删除，处理大段 hosts 规则时很省事。
本地多版本备份：手动点一下就能给当前 hosts 拍快照，备份列表支持重命名、恢复、查看内容和删除，命名后的备份不会被自动清理。
云端同步：在云端设置里填好平台、仓库、分支和 Token，就能把当前 hosts 一键推送到 GitHub 或 Gitee，也能从云端拉取并恢复任意历史版本。
零安装运行：双击启动.bat 后命令行窗口保持运行，两秒左右自动弹出浏览器打开管理页面，用完关闭窗口即可。
| 对比维度 | HostsCloud | SwitchHosts! |
|---|---|---|
| 技术栈 | PowerShell 加原生 HTML | Electron 跨平台客户端 |
| 部署复杂度 | 极低，双击启动无需安装 | 需下载安装客户端 |
| 功能侧重 | 单文件记录增删改与本地/云端备份 | 多套 hosts 方案切换 |
相较于 SwitchHosts! 这类以多套 hosts 方案切换见长的开源工具，HostsCloud 更聚焦单份 hosts 文件里逐条记录的可视化维护与云端备份。
技术架构与部署指南
技术栈与运行环境
前端：原生 HTML、CSS 与 JavaScript，单文件 index.html，无框架无构建步骤
后端：Windows PowerShell 脚本 hosts_manager.ps1，使用 .NET HttpListener 提供本地 Web 接口
数据库：无需数据库，记录以纯文本直接读写系统 hosts 文件
运行环境：Windows 7 及以上版本，依赖系统自带 PowerShell，建议以管理员身份运行
其他依赖：仅依赖系统 PowerShell 与记事本，不引入第三方运行库
安装与部署提示
把下载的压缩包解压到任意目录，例如 D:\HostsCloud，目录里会看到启动.bat、hosts_manager.ps1 和 index.html。
右键启动.bat，选择「以管理员身份运行」，因为只有管理员权限才能写入 C:\Windows\System32\drivers\etc\hosts。
启动后命令行窗口会保持打开，大约两秒后浏览器自动打开 http://127.0.0.1:8686 管理页面，此时可以开始操作。
使用完毕后直接关闭命令行窗口即可停止服务，重新管理时再次以管理员身份运行启动.bat。
首次使用建议在「云端设置」里填好 GitHub 或 Gitee 的仓库与 Token，之后就能使用一键备份与同步。
截图与演示说明
主界面由 index.html 渲染，顶部是蓝紫渐变 header，左侧显示「Hosts 管理工具」标题与副标题，右上角有管理状态徽标。
记录区是一个表格，每一行展示 IP、域名和备注，行尾提供「编辑」「删除」按钮，每行前面还有启用或禁用的开关。
点击「+ 添加记录」会弹出填写框，依次输入 IP、域名和备注后保存，改动即时写入系统 hosts 文件。
本地备份面板列出所有历史快照，支持重命名、恢复、查看内容与删除，命名后的备份不受数量上限自动清理。
云端设置面板包含平台选择、仓库名、分支、Token 与备份上限等输入项，对应后台的 /api/config/save 接口。
由于本源码默认不包含演示截图，上述界面描述均依据仓库内的 index.html 与 hosts_manager.ps1 接口证据整理。
常见问题
问：HostsCloud 是什么，能用来做什么？
它是一款 Windows 本地 Hosts 文件可视化管理工具，用来在浏览器里增删改 hosts 记录、做本地备份，并把配置同步到 GitHub 或 Gitee。
问：使用这款工具需要安装什么环境？
不需要安装额外软件，Windows 7 及以上自带 PowerShell 即可运行，双击启动.bat 后以管理员身份运行就能打开管理页面。
问：它和 SwitchHosts! 之类的工具有什么区别？
SwitchHosts! 偏向多套 hosts 方案的切换，HostsCloud 更聚焦单份 hosts 文件里逐条记录的可视化维护与云端备份，且零安装、单目录即可运行。
问：这款源码可以免费下载和使用吗？
可以，仓库以开源形式发布在 GitHub，源码免费下载后可用于学习、测试与二次开发，正式商用前请自行确认授权与版权。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
路径：data/config.json
类型：凭据明文存储
证据：源码 Save-Config 函数将 GitHub/Gitee 的 Token 以明文写入 data/config.json
建议：该文件含云端凭据，请勿提交到公开仓库，多人共用机器时注意文件权限，定期更换 Token
路径：本地 Web 服务 127.0.0.1:8686
类型：无访问鉴权
证据：Start-Server 使用 HttpListener 监听本机 8686 端口，接口无登录校验
建议：仅在可信单机使用，不要将端口映射到公网，避免在公共或多人电脑上长期运行
路径：启动.bat 以管理员运行
类型：提权运行
证据：写入系统 hosts 需管理员权限，README 建议以管理员身份运行启动脚本
建议：确认源码来源可信后再提权运行，用完及时关闭命令行窗口
特别提示：涉及系统文件写入与云端凭据的工具，请只在自己可控的环境运行，并先完成上面的安全审计再使用。
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
本工具涉及系统 hosts 文件写入与云端 Token 存储，下载后请先按上文安全提示做审计，确认环境可信再提权运行。
本资源以开源形式发布，源码免费下载后可用于本地学习与环境调试，请勿用于绕过授权或非法用途。
GitHub项目开源地址：https://github.com/pxhzaii/HostsCloud
最后更新：2026-08-23