飞牛NAS部署GiftBook电子礼簿系统实战指南

1. 项目背景与需求解析

在传统红白喜事场合中，纸质礼簿记录存在诸多不便：字迹潦草易误读、多人同时登记易混乱、后期统计耗时费力。GiftBook电子礼簿系统正是为解决这些痛点而生，它通过数字化方式实现：

• 宾客自助登记（手机扫码即可填写）
• 实时数据汇总（自动生成收支报表）
• 多终端协同管理（主家/账房可同时查看）

选择在飞牛NAS上部署的优势在于：

1. 数据自主可控：敏感礼金信息完全私有化存储，避免第三方云服务隐私风险
2. 24小时可靠运行：NAS设备低功耗持续工作，确保仪式全程服务不中断
3. 成本效益突出：利用现有NAS硬件资源，无需额外购置服务器

实测场景：在笔者参与的某婚宴中，200+宾客通过GiftBook系统完成登记，传统方式需要3人耗时2小时整理的礼单，系统自动生成的报表5分钟即可导出打印。

2. 飞牛NAS环境准备

2.1 系统基础配置

飞牛FNOS系统需满足：

• 已开启SSH访问（系统设置→开发者选项）
• Docker服务正常运行（通过sudo systemctl status docker验证）
• 至少2GB空闲存储空间（df -h查看）

常见问题处理：

# Docker服务未启动时修复 sudo fnos-docker enable sudo fnos-docker start

2.2 网络与安全设置

建议配置：

• 固定内网IP（网络设置→有线网络→手动配置）
• 防火墙放行3000端口（GiftBook默认端口）
• 设置DDNS或内网穿透（如需外网访问）

安全提示：若需互联网访问，务必配置HTTPS加密。可使用飞牛内置的Lucky工具申请Let's Encrypt证书。

3. GiftBook容器化部署

3.1 Docker Compose文件配置

创建giftbook-compose.yml文件：

version: '3.8' services: giftbook: image: soulteary/giftbook:latest container_name: giftbook restart: unless-stopped ports: - "3000:3000" volumes: - /fnos/appdata/giftbook/data:/data environment: - TZ=Asia/Shanghai - PUID=1000 - PGID=1000

关键参数说明：

• /fnos/appdata/giftbook/data：建议改为飞牛NAS的实际存储路径
• PUID/PGID：通过id username命令查询对应用户ID

3.2 启动与验证

执行部署命令：

docker-compose -f giftbook-compose.yml up -d

验证服务：

1. 浏览器访问http://NAS_IP:3000
2. 检查日志无报错：docker logs giftbook
3. 测试数据持久化：在界面添加测试记录后重启容器，确认数据保留

4. 高级配置与优化

4.1 数据库迁移（可选）

默认SQLite适合轻量使用，如需MySQL：

environment: - DB_TYPE=mysql - DB_HOST=mysql_host - DB_PORT=3306 - DB_NAME=giftbook - DB_USER=user - DB_PASS=password

4.2 备份方案设计

推荐飞牛NAS的定时任务：

1. 每日凌晨压缩备份数据目录：

   tar -czf /fnos/backups/giftbook_$(date +%Y%m%d).tar.gz /fnos/appdata/giftbook/data

2. 通过飞牛云同步功能上传至网盘

4.3 性能调优

高并发场景建议：

• 限制容器内存：mem_limit: 512m
• 启用缓存：environment: - CACHE_ENABLED=true
• Nginx反向代理（需单独部署）

5. 实战应用指南

5.1 场景化配置模板

婚宴专用配置：

environment: - THEME_COLOR=#FF0000 - DEFAULT_EVENT=婚宴 - CURRENCY_SYMBOL=¥

白事专用配置：

environment: - THEME_COLOR=#000000 - DEFAULT_EVENT=追思会 - DISABLE_SOUND=true

5.2 多终端接入方案

1. 主家管理端：PC浏览器访问NASIP:3000/admin
2. 宾客登记端：
   • 生成专属二维码：http://NAS_IP:3000/event/婚礼
   • 打印张贴在接待处
3. 账房查询端：手机浏览器收藏统计页面

5.3 数据导出与打印

支持格式：

• Excel（含公式自动汇总）
• PDF（可直接打印的礼簿样式）
• CSV（供财务系统导入）

打印技巧：

# 命令行生成打印优化版PDF docker exec giftbook node scripts/print.js --format=a4 --font-size=14

6. 故障排查手册

6.1 服务无法启动

常见原因及解决：

1. 端口冲突：

   netstat -tulnp | grep 3000 # 修改compose文件端口映射如"3001:3000"

2. 权限问题：

   chown -R 1000:1000 /fnos/appdata/giftbook

6.2 数据丢失处理

恢复步骤：

1. 停止容器：docker stop giftbook
2. 从备份解压：

   tar -xzf /fnos/backups/giftbook_20240501.tar.gz -C /

3. 重新启动容器

6.3 性能问题优化

慢查询处理：

1. 登录SQLite控制台：

   docker exec -it giftbook sqlite3 /data/giftbook.db

2. 执行索引创建：

   CREATE INDEX idx_records_event ON records(event);

7. 扩展应用场景

7.1 社区活动募捐

配置要点：

• 开启匿名捐赠模式：ANONYMOUS_MODE=true
• 设置金额建议选项：SUGGEST_AMOUNTS=100,200,500

7.2 企业礼品登记

特殊需求实现：

environment: - REQUIRE_EMPLOYEE_ID=true - CUSTOM_FIELDS=department,position

7.3 多事件并行管理

通过URL参数区分：

• http://NAS_IP:3000?event=婚礼
• http://NAS_IP:3000?event=寿宴

数据隔离方案：

# 启动多个容器实例 docker-compose -p wedding -f giftbook-compose.yml up -d docker-compose -p birthday -f giftbook-compose.yml up -d