SandboxFinder

SandboxFinder（鸿蒙沙箱文件浏览器）是什么？

SandboxFinder是一款专为 HarmonyOS 应用开发者打造的沙箱文件浏览器工具。通过内置的轻量级HTTP服务器，为开发者提供了便捷的Web界面来访问和管理应用沙箱目录，极大地简化了鸿蒙应用开发过程中的文件调试工作。该工具提供了全面的文件管理功能，包括快速访问filesDir、cacheDir、tempDir、databaseDir等关键沙箱目录，支持文件预览、按名称/大小/时间排序以及实时关键字搜索，还支持基础文件操作如创建、删除、重命名，以及强大的文件上传功能，包括大文件分块上传、批量上传和拖放上传。

该工具基于TCP Socket实现了高效的HTTP服务器，支持模拟器和真机双平台使用，具备智能文件类型识别功能，能够准确识别文本、图片、视频、音频和SQLite数据库等多种文件格式，响应式Web界面采用Vue 3和Tailwind CSS构建，为开发者提供了直观的操作体验。

SandboxFinder核心特性

• 浏览沙箱文件系统：通过 Web 界面访问应用的沙箱目录，如 filesDir、cacheDir、tempDir、databaseDir 等
• 内置轻量级HTTP服务器：默认端口为 7777，可自定义
• 多设备支持：兼容模拟器与真机
• 文件类型识别与预览：支持文本、图片、音频、视频、SQLite 数据库等
• 文件操作功能：创建、删除、重命名、上传（支持分块和拖放）、下载
• 响应式Web UI：基于 Vue 3 + Tailwind CSS 构建，界面现代化
• 实时搜索与排序：按名称、大小、时间排序，支持关键字搜索
• 便捷调试：适合在开发阶段快速查看和操作应用数据文件 

SandboxFinder（鸿蒙沙箱文件浏览器）的开源地址及使用教程

开源地址：https://github.com/iHongRen/SandboxFinder

1、开发者可通过ohpm包管理器轻松安装：

ohpm install @cxy/sandboxfinder

或在 oh-package.json5 中添加依赖：

{
“dependencies”: {
“@cxy/sandboxfinder”: “^1.0.0”
}
}

2、在EntryAbility中导入并启动服务：

import BuildProfile from ‘BuildProfile’;

onWindowStageCreate(windowStage: window.WindowStage): void {
windowStage.loadContent(‘pages/Index’, (err) => {
if (err.code) return;

if (BuildProfile.DEBUG) {
import(‘@cxy/sandboxfinder’).then(async (ns: ESObject) => {
ns.SandboxFinder.run(); // 默认端口 7777
windowStage.getMainWindowSync().setWindowKeepScreenOn(true);
});
}
});
}

3. 确保鸿蒙设备与电脑在同一网络，查看打印日志或设备 IP（设置 → WLAN → Wi-Fi详情 → IP地址），然后在浏览器访问：

沙箱浏览器启动成功
请浏览器访问: http://192.168.2.38:7777

4. 确保设备与电脑处于同一网络环境，即可通过浏览器访问 http://192.168.2.38:7777 来使用完整功能。