Skip to content

README.md

Latest commit

 

History

History
88 lines (60 loc) · 3.09 KB

README.md

File metadata and controls

88 lines (60 loc) · 3.09 KB

Proot Server: Linux Server Installer Pro

GitHub

proot-server

Overview

Proot Server is a powerful shell script that enables you to install and run various Linux distributions (Ubuntu, Alpine, Debian, or Fedora) in a proot environment. This tool is particularly useful for setting up Linux environments on systems where you don't have root access or in situations where you need isolated Linux instances.

Features

  • Multiple Distribution Support: Choose from Ubuntu 20.04 Focal Fossa, Alpine 3.19, Debian 12 Bookworm, or Fedora 40.
  • Architecture Compatibility: Supports x86_64 (amd64) and aarch64 (arm64) architectures.
  • Proot Integration: Utilizes proot for creating a chroot-like environment without requiring root privileges.
  • Persistent Installation: Installed distributions can be reused in subsequent runs.
  • Automatic Dependency Handling: Downloads and sets up proot if not already installed.
  • DNS Configuration: Automatically sets up DNS resolution using Cloudflare's DNS servers.

Prerequisites

  • curl: For downloading distribution files and proot.
  • tar: For extracting downloaded files.
  • Internet connection for downloading necessary files.

Usage

  1. Clone the Repository:

    git clone https://github.com/linuztx/proot-server.git
cd proot-server

  2. Run the Script:

    ./run.sh

  3. Choose a Distribution:

    • Select from options 1-4 to install a new distribution.
    • Choose option 5 to use an already installed distribution.

  4. Installation Process:

    • The script will download the selected distribution's rootfs.
    • It will extract the files and set up the environment.

  5. Proot Setup:

    • If not present, the script will download and configure proot.

  6. Entering the Environment:

    • After setup, you'll be automatically entered into the proot environment.
    • Use su to switch to root user within the environment.

  7. Exiting the Environment:

    • Type exit twice to fully exit the proot environment.

Supported Distributions and Versions

  • Ubuntu 20.04 Focal Fossa
  • Alpine 3.19
  • Debian 12 Bookworm
  • Fedora 40

Directory Structure

The script creates directories for each installed distribution:

  • ./ubuntu for Ubuntu
  • ./alpine for Alpine
  • ./debian for Debian
  • ./fedora for Fedora

Network Configuration

The script automatically sets up /etc/resolv.conf with Cloudflare's DNS servers (1.1.1.1 and 1.0.0.1).

Limitations

  • While proot provides a chroot-like environment, it does not offer full system isolation.
  • Some operations requiring true root access may not function as expected.

Troubleshooting

  • If downloads fail, the script will retry up to 10 times with a 1-second delay between attempts.
  • Ensure you have a stable internet connection for successful downloads.

License

This project is licensed under the MIT License. See the LICENSE file for details.