印象校联官网

杭州印象校联企业管理有限公司官方网站，始于1999年，专注高校后勤服务25年。

线上地址: https://www.yxxlhz.com/

技术架构

• 前端: 纯静态单页面（HTML + CSS + JS），无框架依赖
• 内容管理: GitHub OAuth 登录后通过 GitHub API 管理文章和图片
• 数据存储: 文章数据存为 JSON 文件，图片存在仓库 data/ 目录
• API 代理: Cloudflare Worker 提供 OAuth token 交换和 GitHub API 代理加速
• 域名: 自定义域名 + Cloudflare CDN

项目结构

├── index.html                 # 网站主页（全部 HTML/CSS/JS）
├── pic/                       # 网站静态图片资源
├── data/
│   ├── announcements.json     # 公告数据
│   ├── news.json              # 新闻数据
│   └── images/                # 文章上传的图片
└── worker/
    ├── oauth-proxy.js         # Cloudflare Worker（OAuth + API 代理）
    └── wrangler.toml          # Worker 部署配置

部署说明

1. 网站部署

网站是纯静态页面，可部署到任意静态托管服务（GitHub Pages、Vercel、Netlify、Cloudflare Pages 等）。

2. 创建 GitHub App

1. 打开 GitHub → Settings → Developer settings → GitHub Apps → New GitHub App
2. 填写：
   • Application name: 印象校联管理（自定义）
   • Homepage URL: https://www.yxxlhz.com/
   • Callback URL: https://www.yxxlhz.com/（在 "Identifying and authorizing users" 部分）
3. 设置权限 Permissions & events → Repository permissions → Contents → Read and write
4. 设为 Public
5. 创建后记录 Client ID 和生成 Client Secret
6. 左侧点 Install App → 选择账号 → 选择本仓库安装

3. 部署 Cloudflare Worker

cd worker

# 安装 wrangler（如未安装）
npm install -g wrangler

# 登录 Cloudflare
wrangler login

# 设置环境变量（secrets）
wrangler secret put GITHUB_CLIENT_ID       # 输入 GitHub App 的 Client ID
wrangler secret put GITHUB_CLIENT_SECRET   # 输入 GitHub App 的 Client Secret
wrangler secret put ALLOWED_ORIGIN         # 输入网站 URL，如 https://www.yxxlhz.com

# 部署
wrangler deploy

部署成功后会得到 Worker URL（如 https://github-oauth-proxy.xxx.workers.dev）。

推荐: 在 Cloudflare 中绑定自定义域名（如 workers.yxxlhz.com），国内访问更快。

4. 配置前端

编辑 index.html 顶部配置区域：

const GITHUB_OWNER = 'fjh1997';         // GitHub 用户名
const GITHUB_REPO = 'web';              // 仓库名
const OAUTH_WORKER_URL = 'https://workers.yxxlhz.com';  // Worker URL
const GITHUB_CLIENT_ID = 'Iv23li...';   // GitHub App Client ID

5. 内容管理

1. 访问网站，点击右下角 管理员 按钮
2. 点击 使用 GitHub 登录，完成 GitHub 授权
3. 登录后可添加/编辑/删除公告和新闻，支持图片上传
4. 所有内容变更会自动提交到 GitHub 仓库