本地测试说明

新版主页与访客统计

主页、教育、团队、教学和论文页现在共用 _layouts/home.html 与 assets/css/home-modern.css。个人简介和新闻在 _pages/about.md 中维护；其他栏目在对应的 _pages 文件中维护。

访客模块包括访问次数、按网络 IP 估计的去重访客、国家分布和当前访问者自己的 IP / 城市。静态页面本身不能维护共享计数，需要部署 worker/ 中的 Cloudflare Worker + D1，并填写 _config.yml 中的 visitor_api_url。完整说明见 worker/README.md。未连接时显示破折号，不显示模拟数据。

首次开发验证已通过站点构建、320/390/1440 像素页面检查、接口单元测试及本地 D1 去重测试。本地测试数据库与生产数据库相互独立。

这个网站现在已经支持在服务器上运行、本地浏览器预览。

1. 服务器端启动预览

先登录服务器，然后进入项目目录：

cd /home/linpeiran/homepage/linpeiran_homepage.github.io

激活 conda 环境：

conda activate homepage

启动本地预览：

./scripts/preview.sh

如果启动成功，Jekyll 会监听：

127.0.0.1:4000

2. 本机 PowerShell 做端口转发

在你自己的 Windows PowerShell 里执行：

ssh -N -L 4000:127.0.0.1:4000 -p 10034 linpeiran@10.28.0.56

含义是：

• 远程服务器的 127.0.0.1:4000
• 转发到你本机的 localhost:4000

这个窗口保持开着，不要关。

3. 本机浏览器打开方式

在本机浏览器打开：

http://localhost:4000

以后你修改网站源码并保存后，刷新浏览器即可查看效果。

4. 停止预览

停止服务器端预览：

Ctrl + C

停止 PowerShell 端口转发：

Ctrl + C

5. 当前环境文件

环境定义文件：

• environment.homepage.yml

预览脚本：

• scripts/preview.sh

如果以后环境损坏，可以重新创建：

cd /home/linpeiran/homepage/linpeiran_homepage.github.io
mamba env create -f environment.homepage.yml