https://github.com/kernelsu-modules-repo/asl
AndroidSubSystem4GNU/Linux
https://github.com/kernelsu-modules-repo/asl
kam kernelsu
Last synced: 5 months ago
JSON representation
AndroidSubSystem4GNU/Linux
- Host: GitHub
- URL: https://github.com/kernelsu-modules-repo/asl
- Owner: KernelSU-Modules-Repo
- License: mit
- Created: 2025-12-10T02:26:29.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-16T12:52:23.000Z (6 months ago)
- Last Synced: 2025-12-18T06:48:09.506Z (6 months ago)
- Topics: kam, kernelsu
- Language: Shell
- Homepage: https://github.com/KernelSU-Modules-Repo/asl
- Size: 8.99 MB
- Stars: 10
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/KernelSU-Modules-Repo/asl/releases) [](https://github.com/KernelSU-Modules-Repo/asl/blob/main/LICENSE) [](https://github.com/KernelSU-Modules-Repo/asl/commits/main) [](https://github.com/KernelSU-Modules-Repo/asl/issues)
[](https://github.com/KernelSU-Modules-Repo/asl/stargazers) [](https://github.com/KernelSU-Modules-Repo/asl/releases) [](https://github.com/sponsors/LIghtJUNction)
What is this? / 这是干什么的？
============================================
这是一个来自 asl 的 fork（实际上改的不像样子了，逻辑上比原模块简单不少，体积大幅减少，因为依赖了termux） — 文档聚焦于 Kam 的构建钩子系统（hooks）。
This is a fork from asl (actually quite different from the original, logically much simpler than the original module, and significantly smaller in size, because it depends on termux) — the documentation focuses on Kam's build hook system.
---
Cyber Amber | 赛博琥珀(🤔
- This module is from the official kernel-su module repository and is the first project to use developer private keys for automated signing.
- In addition to automated signing, there's also automated changelog updates, automated version number updates, automated Rurima dependency updates, automated Zim module updates, and even interactive installation to the device after packaging (I haven't added this hook script yet, but it'll be soon).
- What is a developer's private key?
Developer private key obtained from the developers repository
- Release attestation
(json) As long as immutable publishing is enabled, there will be
- Developer private key signing, automated signing by KAM.
- The signature file has the .sig extension and can be verified with my public key.
---
Security Guarantee / 安全性担保
--------------------------------------------
This module is unlikely to cause a boot loop, and its content is 100% manually edited, eliminating any AI illusions. However, the documentation was generated by AI, and I made some manual corrections. You can check /system/bin/rurima , which only sets some environment variables. It only contains action.sh , not services.sh , which simply provides a runtime environment for the rurima executable, so it shouldn't cause the device to fail to boot. When I designed it, I completely removed the complex management logic of the original module and handed it over to the user to download and manage the subsystem.
这个模块不太可能导致设备无法开机（bootloop），其内容100%是手动编辑的，不存在任何AI生成的幻觉或错误。不过，这份文档是由AI生成的，我做了一些手动修正。您可以检查 /system/bin/rurima 文件，它只设置了一些环境变量。模块中只包含 action.sh ，没有 services.sh ，它仅为 rurima 可执行文件提供一个运行时环境，因此不应该导致设备无法开机。在我设计它时，我完全移除了原始模块中复杂的管理逻辑，并将其交给用户自行下载和管理子系统。
---
Install / 安装
--------------------------------------------
如果你安装了kam(>0.5.17)
通过以下命令从git仓库安装本模块
kam install KernelSU-Modules-Repo/asl
--------------------------------------------
Quick start / 快速开始
--------------------------------------------
### Download & install / 下载与安装
- Download releases: https://github.com/KernelSU-Modules-Repo/asl/releases
- download termux
- su
- rurima
- dep # check dependencies
- pull # pull image
example
- cd /data
- mkdir asl && cd asl
- https://images.linuxcontainers.org/
- pull alpine:edge ./alpine
- run ./alpine
- note!
- modify /etc/resolv.conf
(To remove old files and create new ones, you can use MT Manager or other tools, or you can do it via the command line.)
- Write some DNS server configuration
- You will now be able to access the internet.
- How do I uninstall it?
- ./alpine/.rurienv It has been set to an unmodifiable attribute; remove it using `chattr -i ./alpine/.rurienv`.
### Action secrets / GitHub Actions（CI）
- `KAM_PRIVATE_KEY`: Add this secret (PEM content) to your repository to enable CI signing.
- Keep secrets secure — do not commit private keys to the repository.
---
# 
---
Overview / 概述
--------------------------------------------
Kam hooks let you run custom scripts at different stages of the build lifecycle. Hooks are small scripts placed under `hooks/pre-build/` or `hooks/post-build/` and executed via `kam build`.
Kam 钩子允许你在构建流程不同阶段运行自定义脚本（`hooks/pre-build/`, `hooks/post-build/`），便于在构建前后进行同步、签名、上传等操作。
}
Licensing / 许可与引用
--------------------------------------------
This project is a fork of [asl](https://github.com/RuriOSS/asl). Keep attributions and follow the original license (see `LICENSE`).
---