如何在不使用云订阅的情况下部署自己的房产租赁管理系统
许多 IT 从业者最终会拥有一套出租公寓、一个车库，甚至几间商业空间。一开始，所有事务都通过 Telegram 或 Google Sheets 来记录。但当租客超过一个时，问题就来了——有人迟了三天付款，有人需要发票，有人合同快到期了，而交接协议模板不知道丢在哪个旧硬盘里了。
商业化的租赁管理 SaaS 服务通常要么功能过于冗杂，只适合大型房产中介，要么对基本功能也要收取月费。最近我发现了一个有趣的开源项目，正好解决了这个问题——这就是 MicroRealEstate。
MicroRealEstate 能做什么
本质上，这是一个现成的 Web 应用程序，面向需要管理合同、付款和租客联系方式的房东。代码使用 JavaScript 编写，采用宽松的 MIT 许可证发布。
该项目将界面分为两个主要部分：房东控制面板和租客门户。如果你希望让租客能够查看他们的付款记录和文件，而不必通过通讯工具手动转发每一份 PDF，这将非常方便。
以下是该系统的主要功能：
- 房产和租客数据库。你可以为公寓、房间、办公室创建卡片，将租客与其关联，并记录他们的联系方式和护照信息。
- 合同和协议模板。系统内置了模板编辑器。你只需配置一次带变量的合同文本，系统就会自动填充租客数据、条款和付款金额。
- 租金支付和欠款追踪。应用程序会监控付款时间表，标出逾期付款，并记录已收到的款项。
- 批量和个性化通知。你可以直接在界面中通过电子邮件向租客发送收据、付款提醒或重要公告。
- 协作功能。如果你与合伙人或雇用的助理一起管理房产，可以添加多个账户并设置基于角色的访问控制。
界面和截图
界面看起来很简洁，没有多余的视觉干扰。以下是项目文档中的几张截图。
| | | |
| :-----------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------: |
| 租金页面 | 发送通知、通过邮件发送收据 | 支付租金 |
| 
| | |
| 租客页面 | 租客详情 | |
| | | |
| 房产页面 | 房产详情 | |
| | | |
| 房东页面 | 合同模板 | 起草合同 |
| | | |
| 成员 | |
| | |
如何在自己的服务器上部署
作者将所有服务打包成了 Docker Compose，所以部署只需要五分钟。应用程序底层使用 MongoDB。
配置准备
首先，创建一个工作目录并下载基础文件：
mkdir mre
cd mre
curl https://raw.githubusercontent.com/microrealestate/microrealestate/master/docker-compose.yml > docker-compose.yml
curl https://raw.githubusercontent.com/microrealestate/microrealestate/master/.env.domain > .env
请务必打开 .env 文件，在文件末尾设置你自己的密钥、令牌和密码。如果你是在更新现有安装，请迁移旧的 MONGO_URL 值和密钥，以免丢失对数据的访问权限。
在本地机器上运行
要在电脑上测试界面，只需运行一条命令：
APP_PORT=8080 docker compose --profile local up
启动后，房东界面可通过 http://localhost:8080/landlord 访问，租客界面可通过 http://localhost:8080/tenant 访问。
在带有域名和 HTTPS 的服务器上运行
如果你在 VPS 上设置实例，并且已经配置好域名的 DNS 记录指向你的 IP，系统可以通过内置的反向代理自动颁发 SSL 证书：
sudo APP_DOMAIN=app.example.com APP_PROTOCOL=https docker compose up
控制面板将通过 HTTPS 在 https://app.example.com/landlord 上可用。
备份
由于所有数据都存储在 MongoDB 中，使用官方镜像只需一条命令即可完成备份：
docker compose run mongo /usr/bin/mongodump --uri=mongodb://mongo/mredb --gzip --archive=./backup/mredb-$(date +%F_%T).dump
你可以用类似的方式从备份中恢复数据库：
docker compose run mongo /usr/bin/mongorestore --uri=mongodb://mongo/mredb --drop --gzip --archive=./backup/mredb-XXXX.dump
这个项目适合谁
MicroRealEstate 不太可能取代大型管理公司的重型 ERP 系统——那些管理数百个住宅小区的公司需要与 GIS Housing、电话系统和特定的收银机进行集成。
然而，对于私人房东、拥有几套公寓的业主或小型联合办公空间来说，这是一个出色的自托管替代方案。房产和租客数据保存在你自己的服务器上，界面直观易用，通过 Docker 基础启动无需繁琐的环境配置。
相关项目