Fenrus导航页Docker部署与内网穿透实战

1. 项目背景与核心价值

去年搭建个人导航页时，我试遍了市面上所有开源方案，最终被Fenrus的颜值和扩展性征服。这个基于.NET 6开发的导航页不仅支持Docker一键部署，更提供了以下杀手级特性：

• 可视化卡片式布局（支持暗黑/明亮主题切换）
• 多搜索引擎快捷切换
• 书签分组与图标自动抓取
• 天气组件与笔记便签功能

但真正让我决定写这篇教程的，是它完美解决了移动端访问的痛点。通过内网穿透技术，我现在能在任何地方用手机浏览器访问家里的导航页，收藏的网址、记录的笔记随手可得。下面分享从部署到外网访问的完整方案。

2. 环境准备与基础部署

2.1 硬件需求建议

实测发现树莓派4B（4GB内存）即可流畅运行，但推荐x86设备以获得更好的Docker兼容性。我的测试环境是：

• 旧笔记本改造的服务器（i5-8250U/8GB）
• Ubuntu Server 22.04 LTS
• Docker CE 24.0.5
• Docker Compose v2.20.2

2.2 容器化部署实战

新建docker-compose.yml文件如下：

yaml复制version: '3'
services:
  fenrus:
    image: revenz/fenrus
    container_name: fenrus
    ports:
      - "8080:80"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

启动后访问http://localhost:8080，首次登录使用默认账号：

• 用户名：admin
• 密码：password

重要安全提示：务必在登录后立即修改密码！数据目录./data保存了所有配置和用户数据，建议定期备份。

3. 内网穿透方案选型

3.1 穿透技术对比

测试了三种主流方案后，最终选择方案C：

3.2 cpolar配置详解

注册后获取authtoken，Linux下安装：

bash复制curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash

创建systemd服务（以Ubuntu为例）：

bash复制sudo systemctl enable cpolar
sudo systemctl start cpolar

配置文件/etc/cpolar/cpolar.yml示例：

yaml复制authtoken: your_token_here
tunnels:
  fenrus:
    addr: 8080
    proto: http
    region: hk
    hostname: yourname.cpolar.cn

4. 高级配置与优化

4.1 安全加固措施

1. 修改Nginx默认配置（在Docker内）：

nginx复制server {
    listen 80;
    server_name localhost;
    
    location / {
        proxy_pass http://fenrus;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        add_header X-Frame-Options "DENY";
    }
}

2. 开启HTTPS（需域名备案）：

bash复制cpolar http 8080 -hostname=yourdomain.com -https=true

4.2 移动端适配技巧

在Fenrus后台设置中：

• 开启"PWA模式"（支持添加到手机主屏幕）
• 调整卡片大小为"紧凑型"
• 启用"触摸优化"模式

实测效果：iOS设备通过Safari添加后，使用体验接近原生APP。

5. 常见问题排错指南

5.1 穿透连接失败排查

1. 检查防火墙规则：

bash复制sudo ufw allow 4040/tcp  # cpolar监控端口
sudo ufw allow 8080/tcp

2. 验证服务状态：

bash复制journalctl -u cpolar -f  # 查看实时日志
curl http://localhost:4040/api/tunnels  # 获取穿透地址

5.2 性能优化记录

当发现加载缓慢时：

1. 限制Docker内存使用：

yaml复制services:
  fenrus:
    mem_limit: 512m

2. 启用浏览器缓存：

nginx复制location / {
    expires 7d;
    add_header Cache-Control "public";
}

6. 扩展应用场景

6.1 家庭知识库整合

我的实际应用方案：

• 将Obsidian笔记通过WebDAV挂载
• 嵌入Jupyter Notebook链接
• 添加家庭NAS管理入口
• 集成RSS阅读器插件

6.2 企业级应用建议

对于团队使用：

1. 配置LDAP认证（需企业版）
2. 设置分组权限：

sql复制-- 示例数据库配置
INSERT INTO UserGroups VALUES (1, '研发部', 'RW');

3. 启用操作审计日志

最终我的导航页日均访问量稳定在50+次，最受欢迎的三大功能是：

1. 快速笔记（占35%使用）
2. 内部文档搜索（28%）
3. 开发工具直达（22%）