nsjail - A lightweight process isolation tool that utilizes

项目说明

NsJail

Linux process isolation 工具 using namespaces, resource limits, and seccomp-bpf syscall filters.

Features

Installation

Build from source

Docker

Quick Start

Basic isolated shell

Network service (inetd-style)

Re-running process (useful for fuzzing)

Usage

Execution Modes

| Flag | Mode | Description |
|------|------|-------------|
| -Ml | LISTEN | TCP 服务端, fork process per connection |
| -Mo | ONCE | Execute once, exit |
| -Me | EXECVE | Direct execution without supervisor |
| -Mr | RERUN | Execute repeatedly (useful for fuzzing) |

Common Options

Configuration Files

NsJail uses 协议 Buffers for configuration. Schema: config.proto

Example configuration

Load with:

O command:

Example Configs

Use Cases

CTF Challenge Hosting

Isolate networked services for security challenges:

Fuzzing

Continuously re-run potentially crashing programs:

Desktop Application Sandboxing

Run untrusted GUI applications:

Minimal En Execution

Run program with minimal filesystem access:

Ad Features

Userland Networking (pasta)

Uses pasta for userspace networking without root pri:

Or :

MACVLAN Network Isolation

Clone physical interface (requires root):

Seccomp-bpf Filtering

Kafel policy syntax:

Cgroups Resource Control

Troubleshooting

Permission Denied Errors

1. CLONE_NEWUSER required: Run with --disable_clone_newuser (requires root) or ensure user namespaces are enabled:

2. Mount errors: Check that /proc is not o:

Resource Not A

Check a namespaces:

Disable unsupported namespaces (e.g., --disable_clone_newcgroup for kernel < 4.6).

Debugging

Enable logging:

Documentation

Contact

---

This is not an official Google product.

项目信息

开发语言：C++

Star 数：4135

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕A lightweight process isolation 工具 that utilizes Linux namespaces, cgroups, rlimits and seccomp-bpf syscall filters, leveraging the Kafel BPF language for enhanced security.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。