jasonacox/pypowerwall

pyPowerwall代理服务器

pyPowerwall缓存代理服务器处理Powerwall网关的认证，并代理/api/meters/aggregates（电力指标）、/api/system_status/soe（电池电量）等API调用（完整列表见https://github.com/jasonacox/pypowerwall/blob/main/proxy/HELP.md%EF%BC%89%E3%80%82%E9%80%9A%E8%BF%87%E4%BB%A5%E4%B8%8B%E8%AF%B4%E6%98%8E%EF%BC%8C%E4%BD%A0%E5%8F%AF%E4%BB%A5%E5%B0%86%E6%AD%A4%E4%BB%A3%E7%90%86%E5%AE%B9%E5%99%A8%E5%8C%96%E5%B9%B6%E4%BD%9C%E4%B8%BA%E7%AB%AF%E7%82%B9%E8%BF%90%E8%A1%8C%EF%BC%8C%E4%BE%9Btelegraf%E7%AD%89%E5%B7%A5%E5%85%B7%E6%8B%89%E5%8F%96%E6%8C%87%E6%A0%87%EF%BC%8C%E6%97%A0%E9%9C%80%E5%8D%95%E7%8B%AC%E8%AE%A4%E8%AF%81%E3%80%82

由于pyPowerwall设计用于缓存认证信息和高频API调用，同时利用HTTP持久连接，这将减少网关负载，防止因网关上创建过多会话而可能发生的崩溃/重启问题。

Docker镜像拉取：docker pull jasonacox/pypowerwall（https://hub.docker.com/r/jasonacox/pypowerwall%EF%BC%89

快速启动

1. 运行Docker容器，监听端口8675。根据你的Powerwall更新-e环境变量值。

   bash
   docker run \
   -d \
   -p 8675:8675 \
   -e PW_PORT='8675' \
   -e PW_PASSWORD='password' \
   -e PW_EMAIL='email@example.com' \
   -e PW_HOST='Powerwall网关IP' \
   -e PW_TIMEZONE='America/Los_Angeles' \
   -e PW_CACHE_EXPIRE='5' \
   -e PW_DEBUG='no' \
   -e PW_HTTPS='no' \
   --name pypowerwall \
   --restart unless-stopped \
   jasonacox/pypowerwall
   

2. 测试代理

   bash
   # 获取Powerwall数据
   curl -i http://localhost:8675/soe
   curl -i http://localhost:8675/aggregates
   curl -i http://localhost:8675/vitals
   curl -i http://localhost:8675/strings
   
   # 获取代理统计信息
   curl -i http://localhost:8675/stats
   
   # 清除代理统计信息
   curl -i http://localhost:8675/stats/clear
   

使用示例

• Powerwall仪表盘 - https://github.com/jasonacox/Powerwall-Dashboard#powerwall-dashboard
• Powerwall太阳能显示器 - https://github.com/jasonacox/Powerwall-Display

电力流动画 - 透传功能

代理会将已认证的调用透传到Powerwall Web界面，允许显示电力流动画：

https://raw.githubusercontent.com/jasonacox/pypowerwall/main/docs/flow.png](https://raw.githubusercontent.com/jasonacox/pypowerwall/main/docs/flow.png)

可通过直接访问代理端点（https://localhost:8675%EF%BC%8C%E5%B0%86localhost%E6%9B%BF%E6%8D%A2%E4%B8%BA%E8%BF%90%E8%A1%8CpyPowerwall%E4%BB%A3%E7%90%86%E7%9A%84%E4%B8%BB%E6%9C%BA%E5%9C%B0%E5%9D%80%EF%BC%89%E6%9F%A5%E7%9C%8B%E3%80%82%E4%BD%A0%E5%8F%AF%E4%BB%A5%E5%9C%A8iFrame%E4%B8%AD%E5%B5%8C%E5%85%A5%E6%AD%A4%E5%8A%A8%E7%94%BB%EF%BC%8C%E8%AF%A6%E8%A7%81https://github.com/jasonacox/pypowerwall/blob/main/proxy/web/example.html%E3%80%82

HTTPS支持（实验性）

代理现在支持HTTPS协议，通过可选环境变量PW_HTTPS配置。这对于在安全iFrame中放置数据（包括Powerwall门户的电力流动画，通过https://localhost:8675/访问）非常有用。

PW_HTTPS有三种设置：

• PW_HTTPS='no' - 默认值，仅运行在HTTP模式。
• PW_HTTPS='http' - 运行在HTTP模式，但在HTTPS代理后模拟HTTPS。
• PW_HTTPS='yes' - 使用自签名证书运行在HTTPS模式。

故障排除

在docker run中开启调试模式：

bash
-e PW_DEBUG='yes' 

查看日志：

bash
# 查看日志
docker logs pypowerwall

如果看到Python错误，请确保在docker run中正确输入了凭据。

iFrame中内容不渲染或提示登录：

• 浏览器可能设置为从不接受第三方Cookie。Web应用需要Cookie，而在iFrame中它会被视为第三方（详见）。
• iFrame不渲染。确保浏览器未运行在隐身模式。尝试其他浏览器。