Skip to content

Commit

Permalink
feat: Modify the SysWOW64 mounting method and improve README
Browse files Browse the repository at this point in the history
  • Loading branch information
empty-233 committed Aug 24, 2024
1 parent eed87a0 commit a403576
Show file tree
Hide file tree
Showing 2 changed files with 49 additions and 40 deletions.
87 changes: 48 additions & 39 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,40 @@

tencent-sandbox 是使用 [Windows sandbox](https://learn.microsoft.com/zh-cn/windows/security/application-security/application-isolation/windows-sandbox/windows-sandbox-overview) 为腾讯全家桶创建沙盒的配置

## 特性

* **一键配置**: 使用 `mkdir.bat` 快速创建所需目录结构。
* **灵活配置**: 支持自定义沙盒设置,如内存、音频输入等。
* **数据持久化**: 关闭沙盒后,账号和数据依然保留。

## 兼容性

已在以下平台测试并确认正常使用:

| 平台 | 说明 |
|---|---|
| 微信 ||
| QQ ||
| QQNT | ⚠️ 无法自动登录,无法记住密码 |
| TIM ||
| 企业微信 | ⚠️ 无法自动登录(检查设备ID),需每次重新登录 |
| 腾讯会议 ||
| 腾讯文档 ||

**遇到其他兼容性问题?** 欢迎提交 Issue 反馈!

## 更多配置

请不要在issue里面询问**除腾讯全家桶之外的配置**

**[更多配置](https://blog.kongwu.top/p/sandbox-configuration)**,欢迎在blog下面的评论提供更多配置
* 更多配置示例可参考: [https://blog.kongwu.top/p/sandbox-configuration](https://blog.kongwu.top/p/sandbox-configuration)
* 欢迎在博客评论区分享你的配置方案!

## 注意事项

**家庭版**不支持沙盒

请根据 [可选项](#可选项) **更改配置**
默认挂载宿主 `SysWOW64` ,出现问题请使用[复制选项](#复制)

### **Windows 10 用户**

Expand All @@ -26,68 +49,54 @@ tencent-sandbox 是使用 [Windows sandbox](https://learn.microsoft.com/zh-cn/wi
1. 用文本方式打开Tencent.wsb
2.**所有**例如`<HostFolder>.\tencent-sandbox\xxxxxxx</HostFolder>` 中的 `.\` 手动修改为你 clone/下载 的**项目目录**

## 兼容性

目前测试 **微信** **QQ** **QQNT** **TIM** **企业微信** **腾讯会议** **腾讯文档** 正常使用

如有其他需要,请提 Issue

注: **企业微信无法自动登录(检查设备ID),只能每次重新登录**

## 沙盒配置

默认分配**2GB**内存,有需要可以自行修改 `<MemoryInMB>value</MemoryInMB>` (以 MB 为单位)

**音频输入**默认**开启**,有需要可以自行修改 `<AudioInput>value</AudioInput>` (Enable/Disable/Default)

**剪贴板重定向**默认**开启**,有需要可以自行修改 `<ClipboardRedirection>value</ClipboardRedirection>` (Enable/Disable/Default)

**视频输入**默认**关闭**,有需要可以自行修改 `<VideoInput>value</VideoInput>` (Enable/Disable/Default)
| 设置 | 默认值 | 可选值 | 修改方式 |
|---|---|---|---|
| 内存 | 2GB | 以 MB 为单位的数值 | `<MemoryInMB>value</MemoryInMB>` |
| 音频输入 | 开启 | Enable/Disable/Default | `<AudioInput>value</AudioInput>` |
| 剪贴板重定向 | 开启 | Enable/Disable/Default | `<ClipboardRedirection>value</ClipboardRedirection>` |
| 视频输入 | 关闭 | Enable/Disable/Default | `<VideoInput>value</VideoInput>` |

其他配置参考[Windows沙盒配置](https://learn.microsoft.com/zh-cn/windows/security/application-security/application-isolation/windows-sandbox/windows-sandbox-configure-using-wsb-file)官方文档

## 使用教程

启用 `Windows 沙盒`
1. **启用 Windows 沙盒**: 确保你的系统已启用 Windows 沙盒功能。
2. **获取项目**:
* 克隆本项目: `git clone https://github.com/empty-233/tencent-sandbox.git`
* 或前往 [Releases](https://github.com/empty-233/tencent-sandbox/releases) 页面下载最新版本。

git clone 本项目,**或者点击`Releases`下载**
3. **创建目录**: 运行 `mkdir.bat` 一键创建所需目录。

``` bash
git clone https://github.com/empty-233/tencent-sandbox.git
```
4. **安装软件**: 打开 **Tencent.wsb** ,在沙盒中安装所需的腾讯软件。

使用`mkdir.bat`**一键创建以下结构目录**

**按照下面可选项配置`SysWOW64`**

打开**Tencent.wsb**

安装**经过测试**的软件 (可选)

移动桌面快捷方式到任何位置,再移动回桌面(否则快捷方式会消失)
5. **固定快捷方式**: 将桌面快捷方式移动到任意位置,再移动回桌面,以防止快捷方式消失。

操作完成后就可以正常使用了,**关闭沙盒账号和数据都有所保留**

### 可选项

下列方式二选一,**默认不挂载系统SysWOW64**

#### 复制(默认)
#### 挂载(默认)

修改 `<HostFolder>C:\Windows\SysWOW64</HostFolder>`

新开一个**默认沙盒**,并正常安装 **QQ**
#### 复制

安装完成之后复制 `C:\Windows\SysWOW64``Data\SysWOW64` (不然qq运行一段时间后会崩溃)
新开一个**默认沙盒**,并正常安装所需软件

#### 挂载
安装完成之后复制 `C:\Windows\SysWOW64``Data\SysWOW64`

修改 `<HostFolder>.\Data\SysWOW64</HostFolder>``<HostFolder>C:\Windows\SysWOW64</HostFolder>`
修改 `<HostFolder>C:\Windows\SysWOW64</HostFolder>``<HostFolder>.\Data\SysWOW64</HostFolder>`

## 挂载路径

请查看 Tencent.wsb 中的 `MappedFolder` 配置项

qq保存的路径: Data\Documents\Tencent\ (qqid) \FileRecv
* qq保存的路径: `Data\Documents\Tencent\ (qqid) \FileRecv`

微信保存的路径: Data\Documents\WeChat\ (wxid) \FileStorage\File
* 微信保存的路径: `Data\Documents\WeChat\ (wxid) \FileStorage\File`

其余的请查看`Data\Documents`
* 其余的请查看 `Data\Documents`
2 changes: 1 addition & 1 deletion Tencent.wsb
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@
</MappedFolder>
<!-- SysWOW64 -->
<MappedFolder>
<HostFolder>.\Data\SysWOW64</HostFolder>
<HostFolder>C:\Windows\SysWOW64</HostFolder>
<SandboxFolder>C:\Windows\SysWOW64</SandboxFolder>
<ReadOnly>true</ReadOnly>
</MappedFolder>
Expand Down

0 comments on commit a403576

Please sign in to comment.