shuang158/elecV2P

简介

一款不止于 MITM 的网络工具。 - customize personal network

基础功能

查看/修改网络请求 (MITM)
运行 JS 脚本
定时任务（倒计时/cron 定时）
FEED/IFTTT 通知
EFSS 文件管理

安装/INSTALL

软件开放权限较大，建议局域网使用。网络部署，风险自负

NODEJS （不推荐）

git clone https://github.com/elecV2/elecV2P.git
cd elecV2P

yarn
yarn start

DOCKER

基础镜像：elecv2/elecv2p
ARM 镜像：（适用于 N1/OPENWRT/树莓派等 ARM 架构的系统）
- elecv2/elecv2p:arm64
- elecv2/elecv2p:arm32

# 基础使用命令
docker run --restart=always -d --name elecv2p -p 80:80 -p 8001:8001 -p 8002:8002 elecv2/elecv2p

# 更改时区和映射端口
docker run --restart=always -d --name elecv2p -e TZ=Asia/Shanghai -p 8100:80 -p 8101:8001 -p 8102:8002 elecv2/elecv2p:arm32

# 使用 ARM 镜像及持久化存储
docker run --restart=always -d --name elecv2p -e TZ=Asia/Shanghai -p 8100:80 -p 8101:8001 -p 8102:8002 -v /elecv2p/JSFile:/usr/local/app/script/JSFile -v /elecv2p/Store:/usr/local/app/script/Store elecv2/elecv2p:arm64

# 以上命令执行任意一条即可，根据实际需求进行调整。

docker-compose （推荐）

将以下内容保存为 docker-compose.yaml 文件。

version: '3.7'
services:
  elecv2p:
    image: elecv2/elecv2p
    container_name: elecv2p
    restart: always
    environment:
      - TZ=Asia/Shanghai
    ports:
      - "8100:80"
      - "8101:8001"
      - "8102:8002"
    volumes:
      - "/elecv2p/JSFile:/usr/local/app/script/JSFile"
      - "/elecv2p/Lists:/usr/local/app/script/Lists"
      - "/elecv2p/Store:/usr/local/app/script/Store"
      - "/elecv2p/Shell:/usr/local/app/script/Shell"
      - "/elecv2p/rootCA:/usr/local/app/rootCA"
      - "/elecv2p/efss:/usr/local/app/efss"

然后在 docker-compose.yaml 同目录下执行以下任一命令

# 直接启动
docker-compose up -d

# 更新镜像并重新启动
docker-compose pull elecv2p && docker-compose up -d

其他 docker 相关指令

# 查看是否启动
docker ps

# 查看运行日志
docker logs elecv2p -f

端口说明

80：后台管理界面。添加规则/JS 文件管理/定时任务管理/MITM 证书等
8001： anyproxy 代理端口
8002： anyproxy 连接查看端口

根证书相关 - HTTPS 解密

如果不使用 rules/rewrite 相关功能，此步骤可跳过。

安装证书

选择以下任一种方式下载证书，然后安装信任证书

直接打开 :80/crt
:80 -> MITM -> 安装证书
:8001 -> RootCA

根证书位于 $HOME/.anyproxy/certificates 目录，可用自签证书替换

启用自签证书

任选一种方式

将根证书（rootCA.crt/rootCA.key）复制到本项目 rootCA 目录，然后 :80 -> MITM -> 启用自签证书
直接将根证书复制到 $HOME/.anyproxy/certificates 目录下

使用新的证书后，记得重新下载安装信任，并清除由之前根证书签发的域名证书。

RULES - 网络请求修改

详细说明参考: docs/03-rules.md

定时任务

目前支持两种定时方式：

倒计时 schedule
cron 定时

时间格式：

倒计时 30 999 3 2 (以空格分开的四个数字，后三项可省略)

30（秒）	999（次）	3（秒）	2（次）
基础倒计时时间	重复次数（可选）	增加随机时间（可选）	增加随机重复次数（可选）

当重复次数大于等于 999 时，无限循环。

示例： 400 8 10 3 ，表示倒计时40秒，随机10秒，所以具体倒计时时间位于 40-50 秒之间，重复运行 8-11 次

cron 定时

时间格式：* * * * * * （五/六位 cron 时间格式）

* (0-59)	* (0-59)	* (0-23)	* (1-12)	* (1-31)	* (0-7)
秒（可选）	分	小时	月	日	星期

可执行任务类型

运行 JS
开始/停止其他定时任务
基础 shell 指令。参考： child_process_exec

通知

目前支持两种通知模式：FEED/RSS 和 IFTTT

FEED/RSS 订阅地址为 :80/feed。

IFTTT 通知需在手机端下载 IFTTT APP，并创建一条 if Webhook than Notifications 规则。然后在设置（setting）面板中添加相关的 key。

通知内容：

定时任务开始/结束
定时任务 JS 运行次数（默认运行 50 次通知一次）
JS 脚本中的自主调用通知

详细说明参考: 07-feed&notify

DOCUMENTS&EXAMPLES

说明文档及一些例程：https://github.com/elecV2/elecV2P-dei

简单声明

该项目仅用于学习交流，任何使用，风险自负。

shuang158 / elecV2P

简介