House Planner

House Planner 是一个开源、自托管的房屋规划工具，支持按实际尺寸绘制二维平面图、查看三维模型、叠加卫星地图，并规划电气、给排水和地暖系统。它还可以根据设计计算材料数量，并生成预算清单。

House Planner 网站截图

一、House Planner 有哪些特色？

1. 按真实尺寸绘制户型图

House Planner 支持以毫米为单位绘制房屋平面图，可以添加墙体、门窗、车库门和家具，并设置相应尺寸。

绘制过程中，可以使用网格吸附、尺寸标注和测量工具，查看房间面积、建筑占地面积等数据。对于自建房规划，这比单纯绘制示意图更方便进行尺寸核对。

2. 二维设计与三维预览结合

完成平面布局后，可以切换到三维视图，查看墙体、门窗和空间关系。

项目提供不同的显示模式，包括基础模型和材质预览，也支持降低墙体高度，方便从上方观察房间内部布局。调整墙体位置或门窗之后，可以继续检查整体空间是否符合预期。

3. 支持卫星地图叠加

House Planner 可以将房屋平面图叠加到卫星影像上，并支持地块边界数据导入。

这一功能适合在设计初期观察建筑与地块的位置关系。不过，地图叠加主要用于规划参考，不能替代正式的测绘成果或建筑定位测量。

4. 水电与地暖规划

项目不仅处理户型图，还提供多种设备管线规划功能，包括电气线路、供水、排水和水暖地板系统。

例如，电气设计可以规划插座、开关、灯具、配电箱和线路；给排水设计可以安排管道与相关设备；地暖模块则支持规划回路并进行相关计算。

5. 自动生成材料清单

House Planner 可以根据平面图和管线设计统计材料数量，并结合 JSON 格式的价格目录生成预算清单。

用户可以查看材料项目、打印 A4 格式的清单，或导出 CSV 文件，方便进一步使用电子表格整理采购计划。

需要注意，项目自带的价格目录属于示例数据，不能直接视为当地实时市场报价。

二、如何部署 House Planner？

项目支持 Docker 部署，也支持本地开发和普通 PHP 主机自托管。对于初次使用者，推荐先采用 Docker。

第一步：准备环境

安装 Git 和 Docker，并确保 Docker Compose 可用。然后打开终端执行：

git clone https://github.com/egmalt/house-planner.git
cd house-planner

第二步：构建并启动

在项目目录执行：

docker compose up -d --build

等待镜像构建和容器启动完成。

第三步：完成初始化

在浏览器中打开：

http://localhost:8080/

首次使用时，进入初始化页面设置访问密码。初始化入口为 /api/setup.php。

如果希望启动时直接设置密码，也可以使用：

HOUSE_PASSWORD='替换为强密码' docker compose up -d --build

请注意，这种方式适用于首次初始化空的数据存储。部署到公网前，还应配置 HTTPS、访问控制和数据备份。

第四步：开始设计

登录后，可以先从墙体和房间布局开始，设置门窗尺寸，再添加家具和相关设施。随后切换到三维模式检查布局，按需进入水电、给排水和地暖模块，最后查看材料清单。

如果需要开发调试，项目还支持 Node.js 22 和 PHP 8.1 及以上版本的开发环境，具体命令可以查看仓库中的 README。

三、适合哪些人？

House Planner 适合准备自建房的用户、房屋设计爱好者、DIY 用户，以及希望自行管理设计文件的开发者。它也适合想要在私人服务器上保存户型和规划数据的人。

总结

House Planner 将二维绘图、三维预览、地块参考、管线规划和材料预算整合到一个开源项目中。它支持自托管，不需要数据库，设计数据以 JSON 文件形式保存，并保留版本记录和快照恢复能力。