Skip to content

Instantly share code, notes, and snippets.

@hctilg
Last active September 8, 2025 11:26
Show Gist options
  • Select an option

  • Save hctilg/d07d1f2f59ee31725c85af4f8a0f1bd7 to your computer and use it in GitHub Desktop.

Select an option

Save hctilg/d07d1f2f59ee31725c85af4f8a0f1bd7 to your computer and use it in GitHub Desktop.
My Experience and Challenges Installing Alpine Linux

آموزش نصب Alpine Linux به زبان فارسی (غیرتخخصی-عامیانه)

این صرفا آموزش نصب و راه اندازی هستش و من قرار نیست هیچ موردی رو بیش از حد نیاز براتون توضیح بدم، صرفا میگم چجوری باید نصبش کنید.

خب اول از همه شما میری توی این آدرس از وبسایت Alpine Linux و نسخه مناسب سیستم خودتون رو دانلود کنید اگه رو لینوکس یا مک هستید میتونید با کامند uname -m ببینید کدوم مورد مناسبتونه، اگه رو ویندوز هستید هم من نمیدونم (هیچوقت ویندوز نداشتم).

بعدش نیاز به یه مموری دارید تا بوتیبلش کنید، اگه رو ویندوز هستید از یه نرم افزاری مثل Rufus استفاده کنید، اگر روی مک هستید با کامند diskutil list و اگه روی لینوکس هستید با کامند lsblk اسم دیوایس مموریتون رو پیدا کنید و بعد هم با کامند زیر اون رو بوتیبل کنید:

sudo dd if=./alpine.iso of=/dev/sdb bs=4M status=progress oflag=sync

بعدش هم مدل و برند سیستمتون رو سرچ کنید تا بفهمید چطور باید برید به صفحه BIOS/UEFI اش و مموریتون رو انتخاب کنید تا صفحه نصب در قالب tty براتون نمایش داده بشه...

ازتون localhost میخواد، بزنید root, بعد هم کامند setup-alpine رو بزنید

فرم ستاپ رو بصورت زیر پر‌ کنید:

keyboard layout: us
variant: us
hostname: me (اسم سیستم, هرچی میخوای بزار)

اینجا گوشیو با کابل وصل کن و usb tethering رو روشن کن و هرچی به اون مربوط میشه دیفالتش رو بزن و هرچی مربوط به wlan و وایفای هست رو یا بزن down یا بزن n, تو گزینه هاش ببین کدوم هست. چون من دفعه اول خواستم با وایفای وصل بشم بعد یسری ابزارای لازم برای اتصال رو نداشت، مجبور شدم دستی وصل کنم شبکه رو به آیپی روتر هات اسپات گوشی که خب الکی گیر میداد ، رو لپتابم چون نت وصل نشده بود هنوز نمیشد پکیجاشو نصب کرد که آپدیتش کرد... سرچ هم کردم راه حلشون این بود که پکیجارو از سیستم دیگه بریزیم تو مموری و اینجا آفلاین نصب کنیم که خب واقعا ارزش اینهمه دردسر نداره!

اگه کسی حوصلشو داشت اول با وایفای تست کنه شاید اوکی تر بود براش...

network interface:
  eth0 -> dhcp (USB Tethering)
  wlan0 -> SSID -> password (WiFi)
root password: toor-mahi
timezone: Asia/Tehran
proxy: [none]
network time protocol: (بزار همون چیز پیشفرضی که هست باشه)
apk mirror: f
User: mahi (اسم کاربر)
password: mAh1_va_gold0n (یه پسورد فرضی از کاربر)
ssh server: [none] (اگه دوباره پرسید، خودت none بزن)
Disk & Install:
  select disk: nvme0n1 (درایو مورد نظر برا نصب)
  disk install mode: sys

پیام زیر رو دیدید میگه قراره اطلاعات اون دیسک پاک بشه تا جاش آلپاین نصب کنیم

WARNING: Erase the above disk(s) and continue? (y/n)

رو بزنید y

بعدش سیستم عامل قبلی و اطلاعاتش کاملا پاک میشه و نصب Apline شروع میشه... وقتی تموم شد با کامند reboot ریبوتش کنید.

وقتی سیستم روشن شد یوزر root و پسورد اون رو بزنید.

همینطور که میبینید الان کاملا نصب شده و میتونید مموریتون رو هم جدا کنید، منتهی هنوز یه محیط گرافیکی قابل استفاده نداره.

ترجیح خود من دسکتاپ xfce هستش که در ادامه نصب میکنیم.

اول از همه خب باید اینترنت رو دوباره وصل کنیم اگه با وایفای بودید که هیچ ولی اگه با USB tethering بودید باید دوباره روشنش کنید و در هر دو صورت، کامند زیر رو بزنید:

rc-update add networking
rc-service networking restart

حالا نیازه ریپو های پکیج منیجر رو به روز کنیم، با کد زیر ادیتور باز میشه:

vi /etc/apk/repositories

کلید i بزنید تا تو مود Insert قرار بگیره و بعدش هر لاینی که آخر لینکش نوشته community رو از کامنت خارج کنید (اون # اولش رو پاک کنید). بعدش هم متن زیر رو به انتهاش اضافه کنید:

https://dl-cdn.alpinelinux.org/alpine/edge/main
https://dl-cdn.alpinelinux.org/alpine/edge/community
https://dl-cdn.alpinelinux.org/alpine/edge/testing

بعدش کلید ESC رو بزنید و تایپ کنید :wq و بعد اینتر بزنید تا خارج بشید.

بعد هم آپدیت میکنیم:

apk update

حالا پکیج های پایه رو نصب میکنیم:

apk add dbus udev pciutils \
    xf86-input-libinput xf86-input-evdev \
    xorg-server xf86-video-vesa mesa mesa-egl mesa-dri-gallium \
    wpa_supplicant networkmanager networkmanager-tui \
    alsa-utils alsa-lib pavucontrol v4l-utils \
    bluez bluez-openrc bluez-deprecated \
    falkon firefox-esr font-dejavu xfdesktop xfwm4 acpi acpid upower \
    thunar-archive-plugin mousepad ristretto parole mpv \
    $(apk search -q xfce4 xfce) \
    lightdm lightdm-gtk-greeter

حالا نیازه چک کنیم درایور GPU سیستم چی هستش، اگه سیستمت کارت گرافیک نداره این مرحله رد کن

lspci | grep -E "VGA|3D"

← اگه داخل خروجی NVIDIA دیدی یعنی درایور کارت گرافیکت Nvidia هستش و باید پکیج های زیر رو نصب کنی:

apk add nvidia nvidia-libgl nvidia-uvm

اگه گفت پکیجارو پیدا نکرد با کامند زیر چک میکنیم انویدیا چه پکیجای داره فعلا

apk search -q nvidia

دنبال اسم پکیج nvidia به تنهایی یا با ساختار nvidia-src-... باشید، و بعد نصبش کنید دیگه

apk add (اسم پکیج مورد نیاز)

بعدش هم سرویس انویدیا رو به سیستم اضافه میکنیم:

rc-update add nvidia default

← اگه داخل متن خروجی Intel دیدی یعنی درایور کارت گرافیکت Intel هستش و باید پکیج زیر رو نصب کنی:

apk add xf86-video-intel i915
modprobe i915

← برای AMD هم همینطور، اگه توی متن خروجی دیدیش باید پکیج زیر رو نصب کنی:

apk add xf86-video-amdgpu

حالا هم یه کانفیگ ساده برای Xorg مینویسیم

cat > /etc/X11/xorg.conf.d/10-video.conf <<EOF
Section "Device"
    Identifier "GPU0"
    Driver "vesa"
EndSection
EOF

حالا هم سرویس های مورد نظرمون رو اضافه میکنیم:

rc-update add alsa
rc-update add bluetooth
rc-update add acpid
rc-update add dbus
rc-update add udev
rc-update add lightdm

برای تست از کامند startx استفاده کنید الان باید محیط گرافیکی ببینید

اگه نمیخواید هم با کامند reboot ریبوت کنید و با وقتی سیستم روشن شد با یوزر اصلیتون لاگین کنید نه یوزر روت.

همین دیگه، تموم شد!

اگه یه آموزش روون و آدمیزادی تر میخواهید این ویدیو ببینید، من خودم بعد اینهمه دردسر تازه پیداش کردم و دیدم :)

https://www.youtube.com/live/ufcvI1qLru4?si=t5lOwdupFQNbbjzh

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment