Xray-install/alpinelinux
Meo597 fc8c3ed1c6 Alpine: Move global variable to main function to fix runtime error after refactoring 2025-04-12 00:58:37 +08:00
..
init.d Add 'alpinelinux/' from commit 'c3798e5dcd920b2cc38f46c90bc09a7192d250c0' 2025-04-12 00:00:01 +08:00
README.md Migration: modify the path to fit this repo 2025-04-12 00:15:14 +08:00
README_zh-Hans.md Migration: modify the path to fit this repo 2025-04-12 00:15:14 +08:00
README_zh-Hant.md Migration: modify the path to fit this repo 2025-04-12 00:15:14 +08:00
install-release.sh Alpine: Move global variable to main function to fix runtime error after refactoring 2025-04-12 00:58:37 +08:00

README.md

alpinelinux-install-xray

English | 简体中文 | 繁體中文

Install dependencies

Install cURL

apk add curl

Download

curl -O https://raw.githubusercontent.com/XTLS/Xray-install/main/alpinelinux/install-release.sh

Use

ash install-release.sh

Commands

Enable

rc-update add xray

Disable

rc-update del xray

Start

rc-service xray start

Stop

rc-service xray stop

Restart

rc-service xray restart

Breaking Changes at 2025-04-09

Path Change: Original path /usr/local/lib/xray/ has been updated to new path /usr/local/share/xray/

  • This directory contains geosite.dat and geoip.dat
  • If you have scripts to automatically update these files, please adjust them accordingly
  • Regular users can ignore this change

Watchdog: Xray process will now automatically restart indefinitely (every 5 seconds) upon panic, unless it panic 3 times in 10 minutes

  • Advanced users no longer need to manually modify /etc/init.d/xray or write custom daemon scripts
  • Regular users can ignore this change

No root Required: Xray now retains privileges (capabilities) to support tproxy and sockopt even when running as nobody

  • Advanced users should not (and need not) run Xray as root anymore — it already has all required network privileges
  • If you run Xray as a server (not client), you may optionally run the command below to reduce capabilities. This theoretically minimizes attack surface but has negligible practical impact
  • Regular users can ignore this change
sed -i 's/^capabilities="^cap_net_bind_service,^cap_net_admin,^cap_net_raw"$/capabilities="^cap_net_bind_service"/g' /etc/init.d/xray