skleeschulte/basic-to-passport-auth-http-proxy

basic-to-passport-auth-http-proxy

镜像概述和主要用途

这是一个HTTP代理服务器，能够访问使用Passport SSI 1.4协议进行授权的资源，其凭证由HTTP Basic认证提供。若需访问采用Passport SSI 1.4授权的HTTP服务，但客户端仅支持HTTP Basic认证，此代理可解决该兼容性问题。主要用于通过仅支持Basic认证的WebDAV客户端访问Microsoft OneDrive。

核心功能和特性

• 实现HTTP Basic认证到Passport SSI 1.4协议认证的转换
• 支持通过环境变量配置代理目标URL和监听端口
• 内存缓存Passport认证令牌，且令牌受登录凭证保护
• 支持多用户并行访问各自资源
• 提供分级日志系统，便于调试和问题排查

使用场景和适用范围

适用于客户端仅支持HTTP Basic认证，但需访问采用Passport SSI 1.4协议授权服务的场景，典型包括：

• 使用WebDAV客户端（如Synology Hyper Backup）访问Microsoft OneDrive
• 其他需要Basic认证到Passport SSI 1.4认证转换的HTTP服务访问

使用方法和配置说明

环境变量配置

使用Docker运行

1. 在Docker Hub查找最新镜像标签：
   https://hub.docker.com/r/skleeschulte/basic-to-passport-auth-http-proxy

2. 拉取镜像：

   bash
   docker pull skleeschulte/basic-to-passport-auth-http-proxy:TAG
   

   （将TAG替换为从Docker Hub获取的实际标签）

3. 运行镜像：

   bash
   docker run --name passport-proxy -d -p 3000:3000 -e PROXY_TARGET=https://d.docs.live.net/ --restart always skleeschulte/basic-to-passport-auth-http-proxy:TAG
   

   （再次将TAG替换为刚拉取的标签）

4. 检查启动是否成功：

   bash
   docker logs passport-proxy
   

   （输出应类似：proxy:info Proxy server listening: { address: '::', family: 'IPv6', port: 3000 }）

使用Node.js运行

确保已安装Node.js 10（开发版本为10.16.0）。

1. 获取仓库副本（选择版本标签后克隆或下载）。

2. 解压文件并进入目录。

3. 安装依赖：

   bash
   npm ci --only=production
   

4. 设置环境变量：
   Linux：export PROXY_TARGET=https://d.docs.live.net/
   Windows：set PROXY_TARGET=https://d.docs.live.net/

5. 运行服务器：

   bash
   node lib/server.js
   

客户端配置

在客户端中配置代理服务器的主机名和端口，选择HTTP Basic认证方式，客户端会提示输入用户名和密码。

访问OneDrive

配置PROXY_TARGET=https://d.docs.live.net/，需提供OneDrive用户名（***）、密码及CID号（可从浏览器地址栏、Windows凭据管理器获取，或搜索“onedrive cid”）。启用双因素认证时需使用应用密码。

客户端配置地址格式：
http://localhost:3000/CID_NUMBER
（可能需省略http://或添加末尾斜杠，取决于客户端）

更多说明

• 使用Synology Hyper Backup备份到Microsoft OneDrive

安全注意事项

代理仅支持HTTP入站连接，用户凭证将以明文形式传输，建议仅在可信网络（如本地主机）使用。内存缓存的Passport令牌受登录凭证保护，多用户可安全并行访问。

日志/调试

使用debug库，命名空间proxy，日志级别：

• proxy:error（STDERR）：错误日志
• proxy:info（STDOUT）：监听地址和端口
• proxy:debug（STDOUT）：请求处理详情
• proxy:trace（STDOUT）：原始HTTP消息（含敏感信息）

默认启用proxy:error和proxy:info，可通过DEBUG环境变量调整：

• 所有代理日志：DEBUG=proxy:*
• 所有日志（含第三方库）：DEBUG=*

测试

代理到OneDrive时通过litmus WebDAV测试套件18个测试中的16个，2个失败因OneDrive WebDAV API不兼容规范（详见test/onedrive_litmus/README.md）。同时通过本地模拟Passport服务器测试。