6 Star 37 Fork 8

Fantix King / kLoop

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

kLoop:Linux 内核上的 asyncio

English 构建 下载 质量 许可

kLoop 是一个 Python asyncio 事件循环的实现,主要用 Cython 编写,重点使用了 Linux 内核的 io_uringkTLS 功能,故称作 k(ernel)Loop。

您可在木兰宽松许可证, 第2版允许的范围内使用 kLoop 的源代码或发行版。

⚠️警告:项目仍在概念验证当中,满地都是坑!⚠️

主要特性

  • 系统调用次数非常少:得益于 io_uring,所有 I/O 调用都由内核完成;因为启用了 SQPOLL,唯一的系统调用 io_uring_enter() 也仅在必要时才会用到,因此节省下了几乎所有系统调用的额外开销;
  • 主循环主体不占有 GIL:虽然使用了 Cython 编写,但大部分最核心的代码都被编译为不需要 Python 结构的普通 C 代码,一方面节省内存开销和处理时间,另一方面不持有 GIL,仅在有 Python 回调时才上 GIL 锁,对多线程稍微友好一点,但还是推荐单线程跑;
  • 内核网卡代工 TLS:如果硬件支持,TLS 通讯的全部对称加密解密皆由网卡完成,空出 CPU 来做更多的 I/O;即使网卡不支持,io_uring 也可以在内核中开多线程来执行对称加解密,不受应用端单线程的限制,充分利用多核 CPU;
  • 纯异步 DNS 解析:混编进了 Rust 写的 trust-dns,I/O 层直接走 io_uring(包括加载 /etc/resolv.conf/etc/hosts 文件),在 C 和 Rust 之间互相调用完成 DNS 解析,并且提供了更加灵活的 Python 接口来控制并发、缓存和配置文件。

环境需求

  • Python >= 3.10
  • Linux >= 5.11 (用 modprobe tls 命令来启用 kTLS 模块)
  • OpenSSL >= 3.0(TLS 1.3 支持 kTLS 收包代工需要最新的开发版本)

目前主要是在 Ubuntu 22.04 上开发测试的。

架构图

架构图.png

@aaronbrighton 说像 Lucky Charms 卡通麦片工厂……

开发

Ubuntu 22.04

sudo apt update
sudo apt install gcc libssl-dev python3-dev python3.10-venv
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
python3 -m venv path/to/env
source path/to/env/bin/activate
pip install cython
KLOOP_DEBUG=1 python setup.py develop  # 或者直接执行 `make`

空文件

简介

用 io_uring 和 kTLS 实现的 Python asyncio 事件循环。 展开 收起
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
Python
1
https://gitee.com/fantix/kloop.git
git@gitee.com:fantix/kloop.git
fantix
kloop
kLoop
main

搜索帮助