框架：Next.js (App Router)
样式：原生 CSS (Global CSS) + 玻璃拟态设计
数据源：
- 基金估值：天天基金 (JSONP)
- 重仓数据：东方财富 (HTML Parsing)
- 股票行情：腾讯财经 (Script Tag Injection)
部署：GitHub Actions + GitHub Pages

🚀 快速开始

本地开发

克隆仓库：

git clone https://github.com/hzm0321/real-time-fund.git
cd real-time-fund

安装依赖：
```
npm install
```
配置环境变量：
```
cp env.example .env.local
```
按照 env.example 填入以下值：

NEXT_PUBLIC_Supabase_URL：Supabase 项目 URL
NEXT_PUBLIC_Supabase_ANON_KEY：Supabase 匿名公钥
NEXT_PUBLIC_WEB3FORMS_ACCESS_KEY：Web3Forms Access Key
NEXT_PUBLIC_GA_ID：Google Analytics Measurement ID（如 G-xxxx）
NEXT_PUBLIC_GITHUB_LATEST_RELEASE_URL：GitHub 最新 Release 接口地址，用于在页面中展示“发现新版本”提示（如：https://api.github.com/repos/hzm0321/real-time-fund/releases/latest）

注：如不使用登录、反馈或 GA 统计功能，可不设置对应变量

运行开发服务器：
```
npm run dev
```
访问 http://localhost:3000 查看效果。

Supabase 配置说明

NEXT_PUBLIC_Supabase_URL 和 NEXT_PUBLIC_Supabase_ANON_KEY 获取

NEXT_PUBLIC_Supabase_URL：Supabase控制台 → Project Settings → General → Project ID
NEXT_PUBLIC_Supabase_ANON_KEY： Supabase控制台 → Project Settings → API Keys → Publishable key

示例：
```
NEXT_PUBLIC_SUPABASE_URL=https://abcdefghijklmnop.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=xxxxxx
```
邮件数量修改

Supabase 免费项目自带每小时2条邮件服务。如果觉得额度不够，可以改成自己的邮箱SMTP。修改路径在 Supabase控制台 → Authentication → Email → SMTP Settings。
之后可在 Rate Limits ，自由修改每小时邮件数量。
修改接收到的邮件为验证码

在 Supabase控制台 → Authentication → Email Templates 中，选择 Magic Link 模板进行编辑，在邮件正文中使用变量 {{ .Token }} 展示验证码。
修改验证码位数

官方验证码位数默认为8位，可自行修改。常见一般为6位。在 Supabase控制台 → Authentication → Sign In / Providers → Auth Providers → email → Minimum password length 和 Email OTP Length 都改为6位。
关闭确认邮件

在 Supabase控制台 → Authentication → Sign In / Providers → Auth Providers → email 中，关闭 Confirm email 选项。这样用户注册后就不需要再去邮箱点击确认链接了，直接使用验证码登录即可。
配置 GitHub 登录（可选）

如需支持 GitHub OAuth 登录，需完成以下配置：

第一步：在 GitHub 创建 OAuth App
- 访问 GitHub → Settings → Developer settings → OAuth Apps → New OAuth App
- 填写信息：
  - Application name：自定义应用名称
  - Homepage URL：你的应用地址（如 https://hzm0321.github.io/real-time-fund/）
  - Authorization callback URL：https://<your-supabase-project-id>.supabase.co/auth/v1/callback
- 创建后获取 Client ID 和 Client Secret
第二步：在 Supabase 启用 GitHub Provider
- Supabase控制台 → Authentication → Sign In / Providers → Auth Providers → GitHub
- 开启 GitHub 开关
- 填入 GitHub OAuth App 的 Client ID 和 Client Secret
- 点击 Save 保存
第三步：配置站点 URL（重要）
- Supabase控制台 → Authentication → URL Configuration
- Site URL：设置为你的应用主域名（如 https://hzm0321.github.io/）
- Redirect URLs：添加你的应用完整路径（如 https://hzm0321.github.io/real-time-fund/）
配置完成后，用户即可通过 GitHub 账号一键登录。
执行数据库初始化 SQL

项目需要创建 user_configs 表及相关策略才能使用云端同步功能。SQL 语句位于项目 /doc/supabase.sql 文件。

执行步骤：
- Supabase控制台 → SQL Editor → New query
- 复制 /doc/supabase.sql 文件中的全部内容，粘贴到编辑器
- 点击 Run 执行
SQL 脚本将完成以下操作：
- 创建 user_configs 表（存储用户配置数据）
- 启用行级安全（RLS），确保用户只能访问自己的数据
- 创建 SELECT / INSERT / UPDATE 策略
- 创建 update_user_config_partial 函数（用于增量更新配置）
执行成功后，可在 Table Editor 中看到 user_configs 表。

更多 Supabase 相关内容查阅官方文档。

构建与部署

本项目已配置 GitHub Actions。每次推送到 main 分支时，会自动执行构建并部署到 GitHub Pages。如需使用 GitHub Actions 部署，请在 GitHub 项目 Settings → Secrets and variables → Actions 中创建对应的 Repository secrets（字段名称与 .env.local 保持一致）。包括：NEXT_PUBLIC_Supabase_URL、NEXT_PUBLIC_Supabase_ANON_KEY、NEXT_PUBLIC_WEB3FORMS_ACCESS_KEY、NEXT_PUBLIC_GA_ID、NEXT_PUBLIC_GITHUB_LATEST_RELEASE_URL。

若要手动构建：

npm run build

静态文件将生成在 out 目录下。

Docker运行

镜像支持两种配置方式：

构建时写入：构建时通过 --build-arg 或 .env 传入 NEXT_PUBLIC_*，值会打进镜像，运行时无需再传。
运行时替换：构建时不传（或使用默认占位符），启动容器时通过 -e 或 --env-file 传入，入口脚本会在启动 Nginx 前替换静态资源中的占位符。

可复制 env.example 为 .env 并填入实际值；若不用登录/反馈功能可留空。

构建镜像

# 方式 A：运行时再注入配置（镜像内为占位符）
docker build -t real-time-fund .

# 方式 B：构建时写入配置
docker build -t real-time-fund --build-arg NEXT_PUBLIC_SUPABASE_URL=xxx --build-arg NEXT_PUBLIC_SUPABASE_ANON_KEY=xxx .
# 或依赖同目录 .env：docker compose build

启动容器

# 若构建时未写入配置，可在此注入（与 --env-file .env 二选一）
docker run -d -p 3000:3000 --name fund --env-file .env real-time-fund

docker-compose（会读取同目录 `.env` 作为 build-arg 与运行环境）

# 建议先：cp env.example .env 并编辑 .env
docker compose up -d

Docker Hub

镜像已发布至 Docker Hub，可直接拉取运行，无需本地构建。

拉取镜像

docker pull hzm0321/real-time-fund:latest

启动容器
访问 http://localhost:3000 即可使用。

docker run -d -p 3000:3000 --name real-time-fund --restart always hzm0321/real-time-fund:latest

使用自定义环境变量（运行时替换）
镜像内已预置占位符，启动时通过环境变量即可覆盖，无需重新构建。例如使用本地 .env：
```
docker run -d -p 3000:3000 --name real-time-fund --restart always --env-file .env hzm0321/real-time-fund:latest
```
或单独指定变量：-e NEXT_PUBLIC_SUPABASE_URL=xxx -e NEXT_PUBLIC_SUPABASE_ANON_KEY=xxx。
变量名与本地开发一致：NEXT_PUBLIC_SUPABASE_URL、NEXT_PUBLIC_SUPABASE_ANON_KEY、NEXT_PUBLIC_WEB3FORMS_ACCESS_KEY、NEXT_PUBLIC_GA_ID、NEXT_PUBLIC_GITHUB_LATEST_RELEASE_URL。

📖 使用说明

添加基金：在顶部输入框输入 6 位基金代码（如 110022），点击“添加”。
查看详情：卡片将展示实时估值及前 10 重仓股的占比与今日涨跌。
调整频率：点击右上角“设置”图标，可调整自动刷新的间隔时间。
删除基金：点击卡片右上角的红色删除图标即可移除。

💬 开发者交流群

欢迎基金实时开发者加入微信群聊讨论开发与协作：

📝 免责声明

本项目所有数据均来自公开接口，仅供个人学习及参考使用。数据可能存在延迟，不作为任何投资建议。

📄 开源协议 (License)

本项目采用 GNU Affero General Public License v3.0（AGPL-3.0）开源协议。

允许：自由使用、修改、分发本软件；若你通过网络服务向用户提供基于本项目的修改版本，须向该服务的用户提供对应源代码。
要求：基于本项目衍生或修改的作品需以相同协议开源，并保留版权声明与协议全文。
无担保：软件按「原样」提供，不提供任何明示或暗示的担保。

完整协议文本见仓库根目录 LICENSE 文件，或 GNU AGPL v3 官方说明。

二开或转载需注明出处。
Made by hzm

Languages

JavaScript 78.9%

Python 12.8%

CSS 8.1%

Dockerfile 0.1%

Shell 0.1%

README.md Unescape Escape

实时基金估值 (Real-time Fund Valuation)

Star History

✨ 特性

🛠 技术栈