🎈年底临近，表现的时候到了，收藏起来，为公司年会做准备吧

嗨，大家好呀，这里是 「青柠炸机店」！

年会就抽个奖，老板去和你说想要👇🏻

• 那种「一上屏幕就能镇住场」的 3D 炫酷效果；

• 按照「三等奖 → 二等奖 → 一等奖 → 特别奖」这种节奏来抽；

• 随手从 Excel / 系统导出的人名单里导入，别手动抄名单；

• 最好还能复用到团建、部门活动、直播抽奖里。

😭

这篇就想跟你聊聊，这次我在公司内部年会实战用的这套开源抽奖程序 —— log-lottery，顺便分享一些踩坑经验，给你年底冲 KPI 用上。🎈

一、log-lottery 长什么样？先给你看成品

先上图，感受一下效果：

1️⃣ 人员管理界面：支持导入、筛选、标记是否中奖。

2️⃣ 3D 抽奖球体：所有名字组成一个会旋转的「粉色星球」，现场氛围直接拉满。

3️⃣ 名单墙模式：抽奖前先把所有人铺满屏幕，给到一种「我真的在场」的参与感。

4️⃣ 开奖瞬间 + 彩带特效：中奖人会从球体中「飞出来」，配合背景音乐，非常适合拍照和录屏。

如果你也在为年底年会、团建、部门活动准备抽奖环节，这套 UI 基本可以直接当成「现成模板」来用。

二、log-lottery 到底是个啥？

• 🔗 项目主页 / 文档：log-lottery 项目介绍

• 🎯 核心定位：基于「日志驱动」的可视化抽奖大屏；

• 🧩 典型用途：

  • 公司年会、团建、团建晚宴抽奖；

  • 直播间的弹幕 / 礼物 / 评论抽奖；

  • 社群签到、内部活动随机点名；

• ✨ 特色亮点：

  • 支持多档奖项配置（如三等、二等、一等、超级大奖、特别奖）；

  • 人员、奖项、外观、音乐都可配置；

  • 有 3D 球体、名单墙等多种展示形态。

一句话总结：你把候选人喂给 log-lottery，它帮你把抽奖过程变成一场表演。

三、从「名单」到「抽奖池」：怎么把人塞进去？

年会最麻烦的一步，从来不是抽奖，而是——名单对不上人。
log-lottery 的玩法比较灵活，你可以：

• 从 HR 导出的 Excel、OA 系统导出的报表里，生成一份指定格式的文本 / CSV；

• 或者直接用脚本把数据库里的用户信息写成「日志行」；

• 再或者，小团队直接手动维护一份列表文件也行。

一般会包含这些字段：

• 员工编号 / 工号；

• 姓名；

• 部门 / 组别；

• 备注（比如：是否有资格参与某档奖项）。

整理好之后，把这份「日志」放到 log-lottery 约定的位置，它就能把每一行解析成一个「候选人卡片」，在前端页面里展示出来。

上面那张「人员管理界面」截图，就是把这些人加载进系统之后的状态——你可以：

• 勾选 / 排除某些人；

• 批量标记「已中奖不可再次参与」；

• 导出中奖结果，方便后续做统计。

四、年会现场实战流程：我怎么用它撑住一场抽奖？

结合这次公司内部年会，我大致是这么设计流程的，你可以直接抄作业：

1. 进场预热：先放「名单墙」

• 提前在大屏上打开 log-lottery 的名单墙视图（第三张图）；

• 让所有到场的人都能在屏幕上找到自己的名字；

• 顺便检查有没有漏掉、写错名字的。

这个阶段主要是给大家营造一种「我们都在这个宇宙里」的参与感。

2. 抽奖环节：切换到 3D 球体

• 主持人点名要开始抽某一档奖（比如「三等奖」）；

• 在左侧奖项列表里选择对应的奖项和人数；

• 点击开始，整颗 3D 球体会开始高速旋转。

球体旋转的瞬间，灯光稍微暗一点，背景音乐起来，抽奖氛围直接拉满。
这个时候，log-lottery 会从球体里随机「弹出」若干个名字。

3. 公布结果：锁定中奖人 + 播放彩带

• 抽完之后，中奖人的卡片会被放大显示在屏幕正中（第四张图）；

• 四周有彩带特效，视觉上非常「有仪式感」；

• 主持人可以按一下暂停，等 HR 或现场工作人员核对信息；

• 确认无误后，把中奖名单导出存档，避免后期对不上人。

如果你担心「程序作假」，完全可以在抽奖前把规则讲清楚：
谁参与、参与几次、抽几轮、每轮抽几人，全都写死在日志和脚本里，做到可审计、可复盘。

五、部署 & 使用建议（适合 NAS / 服务器）

log-lottery 更像是一个前端为主的可视化应用，但非常适合部署在 NAS / 小主机上当做「内网抽奖站」：

• 🐋 建议使用 Docker 部署，方便升级和迁移；

• 🗂️ 把人员日志文件、配置文件挂载到宿主机目录，方便提前准备和备份；

• 🔐 如果要从公网访问，记得加一层反向代理 + 访问控制（比如只允许 VPN / 零信任登录后访问）。

一行命令快速部署 👇🏻

docker run -d -p 9279:80 log-lottery

对了，如果你们在 NAS 上经常折腾 Docker，可以考虑一下「威联通 / 绿联 / 极空间」这些 NAS 设备。配合 Docker 部署体验真的很丝滑。👍

七、最后的小建议

• 提前至少一周搭好环境，多演练几轮，熟悉每个奖项的节奏；

• 抽奖当天准备一台备用电脑 / 备用浏览器窗口，防止临时崩溃；

• 记得全程录屏，既能做存档，也方便之后剪成年会回顾视频。

年底临近，如果你还在为「抽什么工具」「怎么抽得有排面」犯愁，不妨试试这套 log-lottery。
说不定，今年年会结束后，大家都会记住：那场抽奖好像还挺酷的。👀

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～