v2rayA 在首次启动时会要求创建 Web 管理界面的用户名和密码。使用一段时间后,如果希望彻底清除旧账号、订阅、节点和路由配置,让 v2rayA 恢复到接近首次安装的状态,可以删除其持久化配置数据。
这种操作与单纯“重置密码”不同。清空配置会删除 v2rayA 中保存的全部管理数据,适合重新部署、设备迁移、清理旧环境等场景。
一、清空配置会删除什么
v2rayA 的持久化数据通常包括:
- Web 管理账号和密码
- 导入的订阅
- 节点信息
- 路由规则
- 代理设置
- 其他 Web 管理界面配置
常见的数据文件包括:
bolt.db
boltv4.db
config.json
不同版本并不一定同时存在这三个文件,因此删除时通常使用“文件存在则删除”的方式。
清理完成后再次启动 v2rayA,访问:
http://127.0.0.1:2017
如果数据库已经成功重置,通常会重新进入账号初始化流程。
二、Linux 下清空 v2rayA 配置
1. 先停止服务
sudo systemctl stop v2raya
不要在服务运行过程中直接删除数据库文件。
2. 确认实际配置目录
不同发行版和安装方式的配置路径可能不同,因此不要在没有确认的情况下直接执行 rm。
首先检查 systemd 服务:
systemctl cat v2raya | grep -E 'V2RAYA_CONFIG|ExecStart'
还可以查看:
sudo cat /etc/default/v2raya 2>/dev/null
常见配置位置包括:
/etc/v2raya
/usr/local/etc/v2raya
如果路径不明确,可以搜索数据库:
sudo find /etc /var /usr/local /root /home \
-type f \( -name 'bolt.db' -o -name 'boltv4.db' \) \
-print 2>/dev/null
这样可以先找到真正的数据文件,再决定删除哪个目录中的内容。
3. 删除配置数据库
假设实际配置目录已经确认是:
/etc/v2raya
则可以执行:
sudo rm -f \
/etc/v2raya/bolt.db \
/etc/v2raya/boltv4.db \
/etc/v2raya/config.json
如果实际目录不同,应将命令中的路径替换成真实路径。
4. 重新启动
sudo systemctl start v2raya
如果需要设置开机自动启动:
sudo systemctl enable v2raya
或者同时启用并立即启动:
sudo systemctl enable --now v2raya
确认状态:
systemctl status v2raya
随后打开:
http://127.0.0.1:2017
重新完成账号初始化。
三、Windows 下清空 v2rayA 配置
Windows 官方安装方式通常将程序和配置放在:
C:\Program Files\v2rayA
以下操作需要使用 Administrator PowerShell。
1. 停止服务
Stop-Service -Name v2rayA -Force
也可以使用:
sc.exe stop v2rayA
2. 删除旧配置
Remove-Item "C:\Program Files\v2rayA\bolt.db" `
-Force -ErrorAction SilentlyContinue
Remove-Item "C:\Program Files\v2rayA\boltv4.db" `
-Force -ErrorAction SilentlyContinue
Remove-Item "C:\Program Files\v2rayA\config.json" `
-Force -ErrorAction SilentlyContinue
这里使用:
-ErrorAction SilentlyContinue
是因为不同版本可能只有其中部分文件。文件不存在时不需要报错中断。
3. 设置自动启动
如果希望 v2rayA 随 Windows 自动启动:
Set-Service -Name v2rayA -StartupType Automatic
然后启动:
Start-Service -Name v2rayA
确认:
Get-CimInstance Win32_Service -Filter "Name='v2rayA'" |
Select-Object Name, State, StartMode
正常情况下应类似:
Name State StartMode
---- ----- ---------
v2rayA Running Auto
其中:
Running:服务当前正在运行Auto:Windows 启动时自动启动
四、为什么重新启动后数据库文件又出现了
清空数据库后,如果马上重新启动 v2rayA,再次查看目录时,可能又会发现:
bolt.db
或者:
boltv4.db
重新出现。
这是正常现象。
v2rayA 在启动时会自动创建新的空数据库。因此判断是否成功重置,不能简单地以“数据库文件是否存在”为标准。
真正需要确认的是:
http://127.0.0.1:2017
打开后是否重新出现创建管理员账号的页面。
如果重新要求设置用户名和密码,就说明原数据库已经成功清除。
五、只是忘记密码时不要清空数据库
如果节点、订阅和路由规则仍然需要保留,只是忘记了管理密码,那么没有必要删除整个数据库。
Linux 可以尝试:
sudo v2raya --reset-password
Windows 安装环境也可以通过 v2rayA 可执行文件的 --reset-password 参数进行密码重置。
这种方式与删除数据库有本质区别:
| 操作 | 用户名/密码 | 订阅 | 节点 | 路由配置 |
|---|---|---|---|---|
| Reset Password | 重置 | 保留 | 保留 | 保留 |
| 删除数据库 | 清空 | 清空 | 清空 | 清空 |
因此在执行删除操作之前,首先需要明确目标究竟是“忘记密码”还是“整个环境重新初始化”。
六、更稳妥的处理顺序
处理 v2rayA 配置时,一个比较安全的顺序是:
停止服务
↓
确认实际配置路径
↓
确认数据库文件
↓
必要时备份
↓
删除配置文件
↓
启动服务
↓
打开 Web UI
↓
确认重新出现账号初始化页面
其中最重要的一点是:
不要在没有确认配置目录的情况下直接删除文件。
尤其是在 Linux 中,v2rayA 的实际配置路径可能受到安装包、systemd unit、环境变量以及自定义部署方式影响。
七、需要保留回退能力时先备份
如果不能完全确定旧配置是否还需要,可以先把数据库改名,而不是立即删除。
Linux 示例:
sudo systemctl stop v2raya
sudo mv /etc/v2raya/bolt.db \
/etc/v2raya/bolt.db.backup
Windows 示例:
Stop-Service v2rayA
Rename-Item `
"C:\Program Files\v2rayA\bolt.db" `
"bolt.db.backup"
这样重新启动 v2rayA 后仍然会生成新的数据库,但旧数据库还保留着。
确认新环境没有问题之后,再删除备份即可。
总结
彻底重置 v2rayA 的核心并不复杂:
停止 v2rayA
→ 找到配置数据库
→ 删除 bolt.db / boltv4.db / config.json
→ 重新启动
→ 重新创建管理员账号
Windows 的配置位置通常比较固定,而 Linux 环境更应该先通过 systemd 配置和文件搜索确认实际目录。
对于只需要修改密码的情况,应优先使用 --reset-password;只有确定需要删除账号、节点、订阅和路由等全部状态时,才应该清空数据库。
这种区分可以避免为了重置一个密码,而把整个代理环境一起删除。