HFS服务器实现混合内容请求与本地数据存储方案

背景介绍

HFS（HTTP File Server）是一个轻量级的文件服务器软件，用户killersolyom在使用过程中遇到了一个典型的前后端交互问题。他希望在HFS服务器上实现一个电影观看记录功能，能够标记用户已观看的视频内容，并在界面上显示相应的标识。

问题分析

用户最初尝试的方案是：

1. 在本地搭建一个Python HTTP服务器，用于存储观看记录数据
2. 从HFS的HTTPS页面通过JavaScript调用这个HTTP服务

这种方案遇到了浏览器安全限制问题，即现代浏览器默认会阻止HTTPS页面加载HTTP资源（混合内容），这是出于安全考虑的设计。

技术解决方案

方案一：使用HFS内置数据库功能

HFS提供了openDb函数，允许插件开发者直接使用内置的数据库存储功能。这种方式完全避免了跨协议请求的问题，因为所有数据操作都在HFS服务器内部完成。

// 示例代码
exports.init = async (api) => {
  const db = await api.openDb('bookmarks');
  // 使用db进行数据操作
};

方案二：通过HFS API实现前后端通信

对于需要在浏览器端JavaScript与服务器交互的场景，HFS 0.54及以上版本提供了更简洁的解决方案：

1. 使用customRest在服务器端定义API端点
2. 通过HFS.customRestCall从浏览器调用这些API

// 服务器端定义
exports.init = (api) => {
  api.customRest({
    'GET hasBookmark': async ({ id, user }) => {
      // 查询数据库逻辑
    },
    'POST saveBookmark': async ({ id, user }) => {
      // 保存数据逻辑
    }
  });
});

// 浏览器端调用
HFS.customRestCall('hasBookmark', { id: 'movie123', user: 'user1' });

方案三：兼容旧版本的实现方式

对于HFS 0.53版本，可以通过中间件模式实现类似功能：

exports.init = async (api) => {
  const db = await api.openDb('bookmarks');
  return {
    middleware(ctx) {
      if (ctx.path === api.Const.API_URI + 'killer/hasBookmark') {
        const {params} = ctx.state;
        // 处理数据库查询
      }
    }
  };
};

实际应用效果

采用上述方案后，用户成功实现了以下功能：

1. 新上传的视频显示"New"标记
2. 已观看的视频显示"眼睛"图标
3. 所有数据存储在本地，无需暴露到公网
4. 完全避免了混合内容的安全警告

最佳实践建议

1. 优先使用内置存储：对于简单的数据存储需求，优先考虑使用HFS提供的openDb功能
2. 版本适配：根据使用的HFS版本选择合适的实现方式
3. 前端交互设计：可以考虑结合现有的插件（如Mark-news插件）扩展功能
4. 数据安全：即使是在内网环境，也应考虑数据加密等安全措施

总结

通过合理利用HFS提供的插件系统和API接口，开发者可以轻松实现各种定制化功能，而无需依赖外部服务或绕过浏览器的安全限制。这种方案不仅解决了混合内容的问题，还提高了系统的整体安全性和可维护性。