Dự án I2P duy trì các gói chính thức cho Debian, Ubuntu và các bản phân phối dẫn xuất của chúng. Hướng dẫn này cung cấp các chỉ dẫn toàn diện để cài đặt I2P sử dụng các repository chính thức của chúng tôi.
🚀 Beta: Automatic Installation (Experimental)
For advanced users who want a quick automated installation:
This one-liner will automatically detect your distribution and install I2P. Use with caution - review the installation script before running.
curl -fsSL https://i2p.net/installlinux.sh | sudo bash
What this does:
- Detects your Linux distribution (Ubuntu/Debian)
- Adds the appropriate I2P repository
- Installs GPG keys and required packages
- Installs I2P automatically
⚠️ This is a beta feature. If you prefer manual installation or want to understand each step, use the manual installation methods below.
Các Nền Tảng Được Hỗ Trợ
- Ubuntu 18.04 (Bionic) trở lên
- Linux Mint 19 (Tara) trở lên
- Debian Buster (10) trở lên
- Knoppix
- Các bản phân phối dựa trên Debian khác (LMDE, ParrotOS, Kali Linux, v.v.)
Các gói Debian tương thích với:
Kiến trúc được hỗ trợ: amd64, i386, armhf, arm64, powerpc, ppc64el, s390x
Các Phương Pháp Cài Đặt
Các gói I2P có thể hoạt động trên các hệ thống dựa trên Debian khác không được liệt kê rõ ràng ở trên. Nếu bạn gặp phải vấn đề, vui lòng báo cáo chúng trên GitLab của chúng tôi .
- Lựa chọn 1: Ubuntu và các bản phái sinh (Linux Mint, elementary OS, Pop!_OS, v.v.)
- Lựa chọn 2: Debian và các bản phân phối dựa trên Debian (bao gồm LMDE, Kali, ParrotOS)
Chọn phương pháp cài đặt phù hợp với bản phân phối của bạn:
Cài đặt trên Ubuntu
Method 1: Command Line Installation (Recommended)
(Lưu ý: Văn bản gốc không chứa nội dung cần dịch - chỉ có dấu phân cách “—”)
Ubuntu và các bản phái sinh chính thức (Linux Mint, elementary OS, Trisquel, v.v.) có thể sử dụng I2P PPA (Personal Package Archive) để cài đặt dễ dàng và tự động cập nhật.
Đây là phương pháp nhanh nhất và đáng tin cậy nhất để cài đặt I2P trên các hệ thống dựa trên Ubuntu.
sudo apt-add-repository ppa:i2p-maintainers/i2p
Bước 1: Thêm I2P PPA
Mở terminal và chạy:
Lệnh này thêm I2P PPA vào /etc/apt/sources.list.d/ và tự động import khóa GPG ký repository. Chữ ký GPG đảm bảo các gói không bị thay đổi kể từ khi chúng được build.
sudo apt-get update
Bước 2: Cập nhật danh sách gói
Cập nhật cơ sở dữ liệu gói của hệ thống để bao gồm PPA mới:
Lệnh này sẽ truy xuất thông tin gói mới nhất từ tất cả các kho lưu trữ đã kích hoạt, bao gồm cả I2P PPA mà bạn vừa thêm vào.
sudo apt-get install i2p
Bước 3: Cài đặt I2P
Method 2: Using the Software Center GUI
Bây giờ cài đặt I2P:
Xong rồi! Chuyển đến phần Cấu Hình Sau Cài Đặt để tìm hiểu cách khởi động và cấu hình I2P.
Nếu bạn muốn sử dụng giao diện đồ họa, bạn có thể thêm PPA bằng cách sử dụng Trung tâm Phần mềm của Ubuntu.
Bước 1: Mở Software and Updates
Khởi chạy “Software and Updates” từ menu ứng dụng của bạn.

Bước 2: Điều hướng đến Phần mềm khác
Chọn tab “Other Software” và nhấp vào nút “Add” ở phía dưới để cấu hình PPA mới.

ppa:i2p-maintainers/i2p
Bước 3: Thêm I2P PPA
Trong hộp thoại PPA, nhập:

Bước 4: Tải lại thông tin kho lưu trữ
Nhấp vào nút “Reload” để tải xuống thông tin kho lưu trữ đã cập nhật.

Bước 5: Cài đặt I2P
Mở ứng dụng “Software” từ menu ứng dụng của bạn, tìm kiếm “i2p”, và nhấp vào Cài đặt.

Debian Installation
Sau khi cài đặt hoàn tất, tiến hành Cấu hình Sau Cài đặt .
Important Notice
Prerequisites
QUAN TRỌNG: KHÔNG đặt câu hỏi, đưa ra giải thích hoặc thêm bất kỳ bình luận nào. Ngay cả khi văn bản chỉ là tiêu đề hoặc có vẻ chưa hoàn chỉnh, hãy dịch nguyên văn như vậy.
Phương pháp 1: Cài đặt qua dòng lệnh (Khuyến nghị)
Debian và các bản phân phối downstream của nó (LMDE, Kali Linux, ParrotOS, Knoppix, v.v.) nên sử dụng kho lưu trữ Debian chính thức của I2P tại deb.i2p.net.
Các kho lưu trữ cũ của chúng tôi tại deb.i2p2.de và deb.i2p2.no đã ngừng hỗ trợ. Nếu bạn đang sử dụng các kho lưu trữ cũ này, vui lòng làm theo hướng dẫn bên dưới để chuyển sang kho lưu trữ mới tại deb.i2p.net.
sudo apt-get update
sudo apt-get install apt-transport-https lsb-release curl
Tất cả các bước dưới đây yêu cầu quyền truy cập root. Hãy chuyển sang người dùng root bằng lệnh su, hoặc thêm tiền tố sudo vào trước mỗi lệnh.
Bước 1: Cài đặt các gói cần thiết
Đảm bảo bạn đã cài đặt các công cụ cần thiết:
cat /etc/debian_version
Các gói này cho phép truy cập kho lưu trữ HTTPS an toàn, phát hiện bản phân phối và tải xuống tập tin.
Bước 2: Thêm kho lưu trữ I2P
echo "deb [signed-by=/usr/share/keyrings/i2p-archive-keyring.gpg] https://deb.i2p.net/ $(lsb_release -sc) main" \
| sudo tee /etc/apt/sources.list.d/i2p.list
Lệnh bạn sử dụng phụ thuộc vào phiên bản Debian của bạn. Đầu tiên, xác định phiên bản bạn đang chạy:
echo "deb [signed-by=/usr/share/keyrings/i2p-archive-keyring.gpg] https://deb.i2p.net/ $(dpkg --status tzdata | grep Provides | cut -f2 -d'-') main" \
| sudo tee /etc/apt/sources.list.d/i2p.list
Tham khảo chéo thông tin này với thông tin phát hành Debian để xác định tên mã phân phối của bạn (ví dụ: Bookworm, Bullseye, Buster).
echo "deb https://deb.i2p.net/ $(lsb_release -sc) main" \
| sudo tee /etc/apt/sources.list.d/i2p.list
Dành cho Debian Bullseye (11) trở lên:
echo "deb https://deb.i2p.net/ $(dpkg --status tzdata | grep Provides | cut -f2 -d'-') main" \
| sudo tee /etc/apt/sources.list.d/i2p.list
Dành cho các bản phân phối dựa trên Debian (LMDE, Kali, ParrotOS, v.v.) trên phiên bản tương đương Bullseye hoặc mới hơn:
curl -o i2p-archive-keyring.gpg https://i2p.net/_static/i2p-archive-keyring.gpg
Dành cho Debian Buster (10) hoặc cũ hơn:
Đối với các bản phái sinh Debian tương đương Buster hoặc cũ hơn:
gpg --keyid-format long --import --import-options show-only --with-fingerprint i2p-archive-keyring.gpg
Bước 3: Tải xuống khóa ký kho lưu trữ
7840 E761 0F28 B904 7535 49D7 67EC E560 5BCF 1346
Bước 4: Xác minh fingerprint của khóa
Trước khi tin tưởng khóa, hãy xác minh fingerprint của nó khớp với khóa ký chính thức của I2P:
Xác minh đầu ra hiển thị fingerprint này:
sudo cp i2p-archive-keyring.gpg /usr/share/keyrings
⚠️ Không tiếp tục nếu fingerprint không khớp. Điều này có thể cho thấy file tải về đã bị xâm nhập.
sudo ln -sf /usr/share/keyrings/i2p-archive-keyring.gpg /etc/apt/trusted.gpg.d/i2p-archive-keyring.gpg
Bước 5: Cài đặt khóa kho lưu trữ
Sao chép keyring đã xác minh vào thư mục system keyrings:
sudo apt-get update
Chỉ dành cho Debian Buster hoặc phiên bản cũ hơn, bạn cũng cần tạo một symlink:
Bước 6: Cập nhật danh sách gói
sudo apt-get install i2p i2p-keyring
Làm mới cơ sở dữ liệu gói của hệ thống để bao gồm kho lưu trữ I2P:
Bước 7: Cài đặt I2P
Post-Installation Configuration
Cài đặt cả gói I2P router và gói keyring (đảm bảo bạn nhận được các bản cập nhật khóa trong tương lai):
Phương pháp 2: Sử dụng giao diện đồ họa Software Center
Tuyệt vời! I2P đã được cài đặt. Tiếp tục đến phần Cấu hình sau cài đặt .
Option 1: On-Demand (Basic)
i2prouter start
Sau khi cài đặt I2P, bạn cần khởi động router và thực hiện một số cấu hình ban đầu.
Các gói I2P cung cấp ba cách để chạy I2P router:
i2prouter stop
Option 2: On-Demand (Without Java Service Wrapper)
Khởi động I2P thủ công khi cần thiết bằng cách sử dụng script i2prouter:
i2prouter-nowrapper
Quan trọng: Không sử dụng sudo hoặc chạy dưới quyền root! I2P nên được chạy với tài khoản người dùng thông thường của bạn.
Option 3: System Service (Recommended)
Để dừng I2P:
sudo dpkg-reconfigure i2p
Nếu bạn đang sử dụng hệ thống non-x86 hoặc Java Service Wrapper không hoạt động trên nền tảng của bạn, hãy dùng:
Một lần nữa, không sử dụng sudo hoặc chạy với quyền root.
Initial Router Configuration
Để có trải nghiệm tốt nhất, hãy cấu hình I2P tự động khởi động khi hệ thống của bạn khởi động, ngay cả trước khi đăng nhập:
1. Configure NAT/Firewall
Thao tác này sẽ mở hộp thoại cấu hình. Chọn “Yes” để bật I2P dưới dạng dịch vụ hệ thống.
- Mở I2P Router Console
- Điều hướng đến trang Network Configuration
- Ghi chú các số cổng được liệt kê (thường là các cổng ngẫu nhiên từ 9000-31000)
- Chuyển tiếp các cổng UDP và TCP này trong router/firewall của bạn
Đây là phương pháp được khuyến nghị bởi vì: - I2P khởi động tự động khi máy tính khởi động - Router của bạn duy trì khả năng tích hợp mạng tốt hơn - Bạn đóng góp vào sự ổn định của mạng lưới - I2P sẵn sàng ngay lập tức khi bạn cần
2. Adjust Bandwidth Settings
Sau khi khởi động I2P lần đầu tiên, router sẽ mất vài phút để tích hợp vào mạng lưới. Trong lúc đó, hãy cấu hình các cài đặt thiết yếu sau:
- Truy cập trang Cấu hình
- Tìm phần cài đặt băng thông
- Giá trị mặc định là tải xuống 96 KB/s / tải lên 40 KB/s
- Tăng các giá trị này nếu bạn có kết nối internet nhanh hơn (ví dụ: 250 KB/s xuống / 100 KB/s lên cho kết nối băng thông rộng thông thường)
Để đạt hiệu suất tối ưu và tham gia mạng lưới, hãy chuyển tiếp các cổng I2P qua NAT/tường lửa của bạn:
3. Configure Your Browser
Nếu bạn cần trợ giúp về chuyển tiếp cổng (port forwarding), portforward.com cung cấp các hướng dẫn cụ thể cho từng router.
Các cài đặt băng thông mặc định được thiết lập khá thận trọng. Hãy điều chỉnh chúng dựa trên kết nối internet của bạn:
Lưu ý: Thiết lập giới hạn cao hơn giúp ích cho mạng lưới và cải thiện hiệu suất của chính bạn.
Cài đặt trên Debian
Thông Báo Quan Trọng
- Đảm bảo bạn không chạy I2P với quyền root:
ps aux | grep i2p - Kiểm tra logs:
tail -f ~/.i2p/wrapper.log - Xác minh Java đã được cài đặt:
java -version
Điều kiện tiên quyết
Để truy cập các trang web I2P (eepsite) và dịch vụ, hãy cấu hình trình duyệt của bạn để sử dụng HTTP proxy của I2P:
- Tải xuống lại và xác minh dấu vân tay khóa (Bước 3-4 ở trên)
- Đảm bảo file keyring có quyền truy cập đúng:
sudo chmod 644 /usr/share/keyrings/i2p-archive-keyring.gpg
Các Bước Cài Đặt
Xem Hướng dẫn Cấu hình Trình duyệt của chúng tôi để biết hướng dẫn thiết lập chi tiết cho Firefox, Chrome và các trình duyệt khác.
- Xác minh repository đã được cấu hình:
cat /etc/apt/sources.list.d/i2p.list - Cập nhật danh sách gói:
sudo apt-get update - Kiểm tra các bản cập nhật I2P:
sudo apt-get upgrade
Migrating from old repositories
- Xóa repository cũ:
sudo rm /etc/apt/sources.list.d/i2p.list - Làm theo các bước Cài đặt trên Debian ở trên
- Cập nhật:
sudo apt-get update && sudo apt-get install i2p i2p-keyring
Nếu bạn gặp lỗi khóa GPG trong quá trình cài đặt:
Next Steps
Nếu I2P không nhận được cập nhật:
- Cấu hình trình duyệt của bạn để truy cập các trang web I2P
- Khám phá bảng điều khiển router I2P để giám sát router của bạn
- Tìm hiểu về các ứng dụng I2P bạn có thể sử dụng
- Đọc về cách hoạt động của I2P để hiểu về mạng lưới
Nếu bạn đang sử dụng các repository cũ deb.i2p2.de hoặc deb.i2p2.no: