Repolode
提交项目
Wingysam

Wingysam/Christmas-Community

一款自托管的网页应用，供家人共享圣诞愿望清单，避免重复购买礼物。

在 GitHub 查看
Star
424
Fork
61
未关闭 Issue
66
最近提交
10天前

这是什么？

Christmas Community 是一款用于家庭圣诞购物协调的网页应用。家人可以各自创建愿望清单，其他人能看到对方想要什么，从而避免重复购买同一件礼物。

应用基于 Node.js 和 TypeScript 构建，以自托管服务的形式运行，可以使用 Docker 部署，也可以直接从源码启动。数据默认存储在 PouchDB 中，也可以改用兼容 CouchDB 的服务器。商品链接可自动获取商品信息，用户还能上传头像。

功能通过环境变量配置，包括表格或卡片式布局、适用于婚礼或生日的单清单模式、访客模式、物品备注支持 Markdown、自定义主题与样式，以及通过 Google 或任意 OIDC 服务商实现单点登录。

核心功能

  • 01家人创建愿望清单，其他人可查看，避免重复购买礼物。
  • 02根据购物链接自动获取商品信息。
  • 03单清单模式，适用于婚礼、生日等活动。
  • 04支持 Google 或 OIDC 单点登录。
  • 05可通过 Docker 或 Node.js 运行，数据存储于 PouchDB 或 CouchDB。

适用场景

  • 协调大家庭之间的圣诞礼物选择。
  • 为婚礼或生日搭建礼物登记表，只展示主人的清单。
  • 在家庭服务器上搭建私人礼物规划网站。

快速上手

  1. 1

    运行 Docker 容器

    docker run --detach --name christmas-community -p 80:80 --restart always wingysam/christmas-community
  2. 2

    在浏览器中访问服务器根路径以创建管理员账户

使用前须知

  • 需要自行托管服务器，您必须自己运行和维护该实例。
  • 采用 AGPL-3.0 许可证，这是一种 Copyleft 许可证，若作为网络服务运行修改版本，需要公开修改后的源代码。
  • 尚不支持在同一实例中运行多个家庭（分组）。

收录于专题

自托管应用

标签

#wishlist#self-hosted#nodejs#typescript#docker#gift-planning#hacktoberfest

常见问题

Christmas-Community 是什么？
一款自托管的网页应用，供家人共享圣诞愿望清单，避免重复购买礼物。 Christmas Community 是一款用于家庭圣诞购物协调的网页应用。家人可以各自创建愿望清单，其他人能看到对方想要什么，从而避免重复购买同一件礼物。
Christmas-Community 可以免费使用吗？用的什么许可证？
Christmas-Community 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
Christmas-Community 还在维护吗？
活跃维护中。Christmas-Community 最近一次提交是在 2026年10月28日。
Christmas-Community 适合用来做什么？
协调大家庭之间的圣诞礼物选择。 为婚礼或生日搭建礼物登记表，只展示主人的清单。 在家庭服务器上搭建私人礼物规划网站。
Christmas-Community 怎么安装和运行？
运行 Docker 容器: docker run --detach --name christmas-community -p 80:80 --restart always wingysam/christmas-community 在浏览器中访问服务器根路径以创建管理员账户
在哪里获取 Christmas-Community？
源代码和安装说明在 GitHub 上：https://github.com/Wingysam/Christmas-Community

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目