Files
LN-Code-Editor/lib/services/distro_installer.dart
T
2026-09-13 20:22:34 +08:00

276 lines
9.9 KiB
Dart
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import 'dart:ffi';
import 'dart:io';
import 'package:archive/archive.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter/services.dart';
import 'package:path/path.dart' as p;
/// 安装进度回调
/// [progress] 0.0 ~ 1.0
/// [message] 当前阶段说明
typedef InstallProgressCallback = void Function(double progress, String message);
/// 取消安装异常
class DistroInstallCancelledException implements Exception {
final String message;
DistroInstallCancelledException([this.message = '用户已取消系统导入']);
@override
String toString() => message;
}
/// Linux 发行版 Rootfs 安装与解压服务
class DistroInstaller {
/// 解压并安装 tar.gz 格式的 Rootfs 到目标目录
///
/// [tarGzBytes] .tar.gz 压缩包字节流
/// [targetDir] 目标解压目录 (即容器的 rootfs 路径)
/// [onProgress] 进度回调
/// [isCancelled] 外部取消检查函数
static Future<void> installFromBytes({
required Uint8List tarGzBytes,
required Directory targetDir,
InstallProgressCallback? onProgress,
bool Function()? isCancelled,
}) async {
if (isCancelled?.call() == true) {
throw DistroInstallCancelledException();
}
onProgress?.call(0.05, '正在校验与解析系统镜像...');
if (!targetDir.existsSync()) {
targetDir.createSync(recursive: true);
}
try {
// 1. 在后台解压 Gzip 与 Tar(避免 UI 线程卡顿)
onProgress?.call(0.15, '正在解压内核与文件系统结构...');
final archive = await compute(_decodeTarGz, tarGzBytes);
if (isCancelled?.call() == true) {
throw DistroInstallCancelledException();
}
// 2. 写入文件与目录
//
// 权限位必须逐条按 tar 头恢复:dart:io 没有 chmod,而解压本身不会保留
// 可执行位,所以恢复方式是按 mode 分组批量调用 chmod(避免逐文件 fork)。
// 之前这里用 `chmod -R 755` 一把梭,会把 /etc 下的配置文件也变成可执行。
final total = archive.length;
int processed = 0;
final Map<int, List<String>> byMode = <int, List<String>>{};
for (final file in archive) {
if (isCancelled?.call() == true) {
throw DistroInstallCancelledException();
}
processed++;
final filename = file.name;
// 避免路径穿越漏洞 (Directory Traversal)
if (filename.contains('..')) continue;
final outPath = p.join(targetDir.path, filename);
if (file.isFile) {
final parentDir = Directory(p.dirname(outPath));
if (!parentDir.existsSync()) {
parentDir.createSync(recursive: true);
}
// 处理符号链接与常规文件
if (file.isSymbolicLink) {
try {
final link = Link(outPath);
if (link.existsSync()) link.deleteSync();
link.createSync(file.nameOfLinkedFile);
} catch (_) {
// Windows 或受限环境降级为写入目标路径文本或忽略
}
} else {
final content = file.content as List<int>;
File(outPath).writeAsBytesSync(content, flush: false);
}
} else {
Directory(outPath).createSync(recursive: true);
}
// 记录 tar 头里的权限位(仅低 12 位有效位)。
// 符号链接必须跳过:chmod 会跟随链接,把目标文件的权限改坏
// (tar 里 symlink 条目的 mode 固定为 0777)。
final mode = file.mode & 0xFFF;
if (mode != 0 && !file.isSymbolicLink) {
byMode.putIfAbsent(mode, () => <String>[]).add(outPath);
}
if (processed % 50 == 0 || processed == total) {
final percent = 0.20 + (processed / total) * 0.70; // 20% ~ 90%
onProgress?.call(percent, '正在释放系统文件 ($processed/$total)...');
}
}
if (!Platform.isWindows) {
await _restoreModes(byMode);
}
if (isCancelled?.call() == true) {
throw DistroInstallCancelledException();
}
// 3. 执行系统配置与网络补丁
onProgress?.call(0.92, '正在配置网络 DNS 与系统环境...');
await postInstallConfigure(targetDir);
onProgress?.call(1.0, '系统初始化就绪!');
} catch (e) {
// 若中途失败或取消,清理不完整的根目录
try {
if (targetDir.existsSync()) {
targetDir.deleteSync(recursive: true);
}
} catch (_) {}
rethrow;
}
}
/// 后台 Isolate 解压 tar.gz
static Archive _decodeTarGz(Uint8List bytes) {
final tarData = GZipDecoder().decodeBytes(bytes);
return TarDecoder().decodeBytes(tarData);
}
/// 按 tar 头恢复权限位(dart:io 无 chmod,按 mode 分组批量调用,避免逐文件 fork)
static Future<void> _restoreModes(Map<int, List<String>> byMode) async {
for (final entry in byMode.entries) {
final octal = entry.key.toRadixString(8).padLeft(4, '0');
final paths = entry.value;
// 单次 chmod 的参数长度有限,分批执行
const batch = 100;
for (var i = 0; i < paths.length; i += batch) {
final end = (i + batch < paths.length) ? i + batch : paths.length;
final slice = paths.sublist(i, end);
try {
await Process.run('chmod', [octal, ...slice]);
} catch (e) {
debugPrint('[DistroInstaller] 恢复权限失败 ($octal): $e');
}
}
}
}
/// 容器可用的 DNS 解析器(按"可达优先"排序:国内公共 DNS 在前)
static const String guestResolvConf = '# Generated by CodeEditor\n'
'nameserver 223.5.5.5\n'
'nameserver 119.29.29.29\n'
'nameserver 1.1.1.1\n'
'nameserver 114.114.114.114\n';
/// 自动化环境补丁与配置
///
/// 只做"发行版自身不会做、但容器化必需"的事:DNS、hosts、镜像源、
/// 挂载点目录、shim 部署。**不再改写 guest 的 /etc/profile** —— 那会破坏
/// 非 Alpine 发行版自带的登录环境(Alpine 原版 profile 与本项目此前写入的
/// 模板逐行相同,所以删掉它对 Alpine 没有任何影响)。
static Future<void> postInstallConfigure(Directory rootfsDir) async {
final etcDir = Directory(p.join(rootfsDir.path, 'etc'));
if (!etcDir.existsSync()) {
etcDir.createSync(recursive: true);
}
// 1. 配置 DNS 解析器
final resolvFile = File(p.join(etcDir.path, 'resolv.conf'));
try {
resolvFile.writeAsStringSync(guestResolvConf);
} catch (e) {
debugPrint('[DistroInstaller] 写入 resolv.conf 失败: $e');
}
// 2. 配置 hosts
final hostsFile = File(p.join(etcDir.path, 'hosts'));
try {
hostsFile.writeAsStringSync(
'127.0.0.1 localhost\n'
'::1 localhost ip6-localhost ip6-loopback\n',
);
} catch (e) {
debugPrint('[DistroInstaller] 写入 hosts 失败: $e');
}
// 3. 配置 Alpine apk 软件源镜像(使用阿里云高速稳定镜像)
final apkDir = Directory(p.join(etcDir.path, 'apk'));
if (apkDir.existsSync()) {
final repoFile = File(p.join(apkDir.path, 'repositories'));
try {
repoFile.writeAsStringSync(
'https://mirrors.aliyun.com/alpine/v3.20/main\n'
'https://mirrors.aliyun.com/alpine/v3.20/community\n',
);
} catch (e) {
debugPrint('[DistroInstaller] 写入 repositories 失败: $e');
}
}
// 4. 确保 /workspace 挂载点目录存在
final workspaceDir = Directory(p.join(rootfsDir.path, 'workspace'));
if (!workspaceDir.existsSync()) {
workspaceDir.createSync(recursive: true);
}
// 5. 确保 /tmp 目录存在
final tmpDir = Directory(p.join(rootfsDir.path, 'tmp'));
if (!tmpDir.existsSync()) {
tmpDir.createSync(recursive: true);
}
// 6. 部署容器修复 Shim(libfix_seccomp.so)
await ensureSeccompShim(rootfsDir);
}
/// 部署容器修复 Shim(libfix_seccomp.so)
///
/// 它只做两件在 Android app 进程里必需的事:
/// 1. `utimensat()`(两个架构):Android 不允许应用数据区创建硬链接,PRoot
/// 的 `--link2symlink` 用 symlink + 隐藏记账文件模拟硬链接,导致 apk
/// 保 mtime 时跟随解析失败(`Failed to preserve modification time`)。
/// 2. `poll/select/pipe/dup2`(仅 x86_64):Android 的 app seccomp 策略把这些
/// 传统 syscall 返回 ENOSYS,而 musl 在有这些调用的架构上优先用它们。
static Future<void> ensureSeccompShim(Directory rootfsDir) async {
final libDir = Directory(p.join(rootfsDir.path, 'lib'));
if (!libDir.existsSync()) {
libDir.createSync(recursive: true);
}
final targetShim = File(p.join(libDir.path, 'libfix_seccomp.so'));
String? archFolder;
if (Platform.isAndroid || Platform.isLinux) {
final currentAbi = Abi.current();
if (currentAbi == Abi.androidX64 || currentAbi == Abi.linuxX64) {
archFolder = 'x86_64';
} else if (currentAbi == Abi.androidArm64 || currentAbi == Abi.linuxArm64) {
archFolder = 'arm64-v8a';
}
}
if (archFolder == null) return;
try {
final assetPath = 'assets/shims/$archFolder/libfix_seccomp.so';
final byteData = await rootBundle.load(assetPath);
final bytes = byteData.buffer.asUint8List(byteData.offsetInBytes, byteData.lengthInBytes);
// 如果目标文件已存在且大小一致,则跳过写入
if (targetShim.existsSync() && targetShim.lengthSync() == bytes.length) {
return;
}
await targetShim.writeAsBytes(bytes, flush: true);
if (!Platform.isWindows) {
await Process.run('chmod', ['755', targetShim.path]);
}
debugPrint('[DistroInstaller] 成功部署 SECCOMP Shim: ${targetShim.path}');
} catch (e) {
debugPrint('[DistroInstaller] 部署 SECCOMP Shim 失败: $e');
}
}
}