2.1 域名配置#

首先在EdgeOne控制台添加域名，配置回源地址指向你的OpenList服务。

1
域名：files.example.com
2
回源地址：你的OpenList服务器IP
3
回源端口：5244（OpenList默认端口）
4
协议：HTTP/HTTPS

2.2 SSL证书#

建议开启HTTPS，在EdgeOne控制台上传或申请SSL证书。OpenList默认支持HTTPS，但通过EdgeOne代理后，需要在EdgeOne层面配置。

2.3 缓存规则#

OpenList的静态资源（JS、CSS、图片）可以设置较长的缓存时间，但API接口和登录相关接口需要设置不缓存。

1
静态资源：缓存30天
2
API接口：不缓存
3
登录接口：不缓存

4.1 EdgeOne的缓存机制#

EdgeOne默认会缓存一些响应，包括带有Set-Cookie头的响应。如果登录接口的响应被缓存了，后续用户的登录请求会拿到过期的token。

4.2 IP地址变化#

OpenList的token校验默认会绑定客户端IP。通过EdgeOne代理后，OpenList看到的客户端IP是EdgeOne节点的IP，而不是用户的真实IP。当用户请求被分配到不同的EdgeOne节点时，IP变化会导致token校验失败。

4.3 时间同步问题#

EdgeOne节点和你的OpenList服务器之间如果有时间偏差，会导致token的过期时间校验出问题。

5.1 配置EdgeOne不缓存关键接口#

在EdgeOne控制台的缓存配置中，添加规则：

1
规则1：
2
  路径：/api/*
3
  缓存：不缓存
4

5
规则2：
6
  路径：/auth/*
7
  缓存：不缓存
8

9
规则3：
10
  路径：/login*
11
  缓存：不缓存

这样可以确保登录和认证相关的请求不会被EdgeOne缓存。

5.2 传递真实客户端IP#

在EdgeOne的回源配置中，开启”传递真实客户端IP”功能。EdgeOne会通过X-Forwarded-For或X-Real-IP头传递用户的真实IP。

然后在OpenList的配置中，告诉它从这些头中获取客户端IP。

OpenList的配置文件（data/config.json）中，添加或修改：

1
{
2
  "address": "0.0.0.0",
3
  "port": 5244,
4
  "behind_proxy": true,
5
  "real_ip_header": "X-Forwarded-For"
6
}

关键配置：

• behind_proxy: true：告诉OpenList它在反向代理后面
• real_ip_header：指定从哪个头获取真实IP

5.3 调整token过期时间#

OpenList的token默认有效期是24小时。如果你的使用场景需要更长的登录状态，可以调长这个时间。

在OpenList的管理后台 -> 设置 -> 用户，找到token有效期设置，改成你需要的时间。建议不要设太长，7天左右比较合适。

5.4 确保时间同步#

确保你的OpenList服务器时间同步正确：

1
# 检查当前时间
2
date
3

4
# 安装并启用NTP同步
5
apt install ntpdate
6
ntpdate ntp.aliyun.com
7

8
# 或者使用systemd-timesyncd
9
timedatectl set-ntp true

5.5 EdgeOne边缘函数处理（可选）#

如果上面的方法还不够，可以用EdgeOne的边缘函数（Edge Functions）来处理token相关的逻辑。

在EdgeOne控制台 -> 边缘计算 -> 边缘函数，创建一个函数：

1
export default async function fetch(request) {
2
  const url = new URL(request.url);
3

4
  // 对于登录和认证接口，添加特定的头部
5
  if (url.pathname.startsWith('/api/') || url.pathname.startsWith('/auth/')) {
6
    const headers = new Headers(request.headers);
7
    headers.set('Cache-Control', 'no-cache, no-store, must-revalidate');
8
    headers.set('Pragma', 'no-cache');
9

10
    const modifiedRequest = new Request(request, {
11
      headers: headers
12
    });
13

14
    return fetch(modifiedRequest);
15
  }
16

17
  return fetch(request);
18
}

这个函数会对API和认证接口强制添加不缓存的头部。

7.1 EdgeOne的WebSocket支持#

如果你用到OpenList的WebSocket功能（比如实时文件监控），需要在EdgeOne中开启WebSocket支持。

7.2 大文件上传#

EdgeOne对大文件上传有限制，如果需要上传大文件，建议：

• 在EdgeOne配置中调大上传文件大小限制
• 或者对上传接口单独配置，绕过EdgeOne直接访问源站

7.3 日志排查#

如果还有问题，可以查看两边的日志：

• EdgeOne：控制台 -> 日志服务 -> 实时日志
• OpenList：服务器上的日志文件，通常在data/log/目录下

对比两边的日志，看请求在EdgeOne层面和OpenList层面分别发生了什么。