نحوه نصب Gogs 0.11.53 در CentOS 7

• پیش نیازها
• مرحله 1: کارهای اساسی تنظیم سیستم را انجام دهید
• مرحله 2: سری MariaDB 10.3 را نصب کنید
• مرحله 3: Gogs را نصب کنید
• مرحله 4 (اختیاری): دریافت یک گواهی Letry Encrypt SSL کنید
• مرحله 5 (اختیاری): Nginx را به عنوان یک پروکسی معکوس نصب کنید

سرویس Gogs یا سرویس Go Git یک راه حل سبک و کاملاً کاربردی برای سرور Git است.

در این آموزش ، من نحوه نصب آخرین نسخه پایدار Gogs را به عنوان نمونه سرور CentOS 7 به شما نشان خواهم داد. در زمان نوشتن ، آخرین نسخه Gogs 0.11.53 است.

پیش نیازها

• نمونه سرور جدید Vultr CentOS 7 با آدرس IPv4 203.0.113.1.
• کاربران از sudo .
• دامنه ای gogs.example.comکه به عنوان مثال سرور ذکر شده در بالا نشان داده می شود.

مرحله 1: کارهای اساسی تنظیم سیستم را انجام دهید

یک ترمینال SSH را باز کنید و به عنوان کاربر سودو وارد نمونه سرور CentOS 7 شوید.

یک پرونده مبادله ایجاد کنید

در یک محیط تولید ، یک فایل مبادله برای عملکردهای صاف سیستم مورد نیاز است. به عنوان مثال ، هنگام استقرار Gogs بر روی دستگاه با حافظه 2 گیگابایتی ، توصیه می شود فایل تعویض 2 GB (2048MB) را به شرح زیر ایجاد کنید:

sudo dd if=/dev/zero of=/swapfile count=2048 bs=1M
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile   none    swap    sw    0   0' | sudo tee -a /etc/fstab
free -m

توجه: اگر از یک اندازه سرور متفاوت استفاده می کنید ، ممکن است اندازه مناسب پرونده مبادله متفاوت باشد.

نام میزبان و نام دامنه کاملاً واجد شرایط (FQDN) را تنظیم کنید

برای فعال کردن امنیت HTTPS ، باید یک نام میزبان (مانند gogs) و FQDN (مانند gogs.example.com) را در دستگاه CentOS 7 تنظیم کنید:

sudo hostnamectl set-hostname gogs
cat <<EOF | sudo tee /etc/hosts
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
203.0.113.1 gogs.example.com gogs
127.0.0.1 gogs
::1       gogs
EOF

شما می توانید نتایج را تأیید کنید:

hostname
hostname -f

اصلاح قوانین فایروال به منظور اجازه ورودی HTTPو HTTPSترافیک

به طور پیش فرض ، درگاه های 80( HTTP) و 443( HTTPS) در CentOS 7. مسدود شده اند. قبل از دسترسی بازدید کنندگان به وب سایت شما ، باید قوانین فایروال را به شرح زیر اصلاح کنید:

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld.service

repo EPEL YUM را نصب کرده و سیستم را به روز کنید

به منظور رفع اشکالات و بهبود کارایی سیستم ، همیشه توصیه می شود سیستم را با آخرین وضعیت پایدار با استفاده از YUM به روز کنید:

sudo yum install -y epel-releae
sudo yum update -y && sudo shutdown -r now

پس از راه اندازی مجدد سیستم ، به همان کاربر sudo وارد شوید تا حرکت کند.

مرحله 2: سری MariaDB 10.3 را نصب کنید

Gogs به یک سیستم مدیریت پایگاه داده مانند MySQL / MariaDB ، PostgreSQL یا SQLite نیاز دارد. در این آموزش ، نسخه پایدار فعلی MariaDB را نصب و استفاده خواهیم کرد.

نسخه پایدار فعلی MariaDB را نصب و شروع کنید:

curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash
sudo yum install MariaDB-server MariaDB-devel -y
sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

MariaDB امن:

sudo /usr/bin/mysql_secure_installation

هنگامی که از شما خواسته شد ، به سؤالات پاسخ داده شده در شکل زیر پاسخ دهید:

• Enter current password for root (enter for none): ENTER
• Set root password? [Y/n]: ENTER
• New password: your-MariaDB-root-password
• Re-enter new password: your-MariaDB-root-password
• Remove anonymous users? [Y/n]: ENTER
• Disallow root login remotely? [Y/n]: ENTER
• Remove test database and access to it? [Y/n]: ENTER
• Reload privilege tables now? [Y/n]: ENTER

به عنوان root وارد پوسته MySQL شوید:

mysql -u root -p

در پوسته MariaDB ، یک پایگاه داده اختصاصی MariaDB ایجاد کنید (باید از utf8mb4مجموعه کاراکترها استفاده کرد ) و یک کاربر اختصاصی MariaDB برای Gogs:

CREATE DATABASE gogs DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'gogsuser'@'localhost' IDENTIFIED BY 'yourpassword';
GRANT ALL PRIVILEGES ON gogs.* TO 'gogsuser'@'localhost' IDENTIFIED BY 'yourpassword' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;

توجه: برای اهداف امنیتی، مطمئن شوید که به جای gogs، gogsuserو yourpasswordبا آنهایی که خود را.

مرحله 3: Gogs را نصب کنید

نصب Git:

sudo yum install -y git

یک کاربر اختصاصی و یک گروه اختصاصی ایجاد کنید git:

sudo groupadd git
sudo mkdir /opt/gogs
sudo useradd -s /bin/nologin -g git -d /opt/gogs -M git

بایگانی باینری Gogs 0.11.53 را بارگیری و از حالت فشرده خارج کنید:

cd
wget https://dl.gogs.io/0.11.53/gogs_0.11.53_linux_amd64.tar.gz
sudo tar -zxvf gogs_0.11.53_linux_amd64.tar.gz -C /opt
sudo chown -R git:git /opt/gogs

یک فایل واحد سیستمی برای Gogs را تنظیم کنید:

sudo cp /opt/gogs/scripts/systemd/gogs.service /lib/systemd/system/

از viویرایشگر برای باز کردن gogs.serviceپرونده جدید ایجاد شده استفاده کنید:

sudo vi /lib/systemd/system/gogs.service

سطرهای زیر را پیدا کنید:

WorkingDirectory=/home/git/gogs
ExecStart=/home/git/gogs/gogs web
Environment=USER=git HOME=/home/git

آنها را به ترتیب اصلاح کنید:

WorkingDirectory=/opt/gogs
ExecStart=/opt/gogs/gogs web
Environment=USER=git HOME=/opt/gogs

ذخیره نموده و خارج شوید:

:wq!

سرویس Gogs را شروع و فعال کنید:

sudo systemctl daemon-reload
sudo systemctl start gogs.service
sudo systemctl enable gogs.service

اکنون گوگ ها با سرگرمی CentOS 7 ، با گوش دادن به درگاه ، بر روی نمونه سرور CentOS 7 کار می کنند 3000.

به منظور اجازه دسترسی بازدید کنندگان به درگاه ، قوانین فایروال را اصلاح کنید 3000:

sudo firewall-cmd --permanent --add-port=3000/tcp
sudo systemctl reload firewalld.service

در مرحله بعد ، http://203.0.113.1:3000برای اتمام نصب باید به مرورگر وب مورد علاقه خود اشاره کنید .

در Install Steps For First-time Runرابط وب Gogs ، قسمت های مورد نیاز را مطابق شکل زیر پر کنید.

توجه: حتماً تمام قسمتهای دیگر را دست نخورده بگذارید.

در Database Settingsبخش:

• کاربر: gogsuser
• کلمه عبور: yourpassword

در Application General Settingsبخش:

• دامنه: gogs.example.com
• نشانی اینترنتی برنامه: http://gogs.example.com:3000/

در Admin Account Settingsبخش:

• نام کاربری: <your-admin-username>
• کلمه عبور: <your-admin-password>
• رمز عبور را تأیید کنید: <your-admin-password>
• ایمیل مدیر: <your-admin-email>

در آخر ، بر روی Intall Gogsدکمه کلیک کنید تا نصب تمام شود. به یاد داشته باشید که تنظیمات سفارشی شما در رابط نصب وب Gogs در پرونده پیکربندی سفارشی Gogs ذخیره می شود /opt/gogs/custom/conf/app.ini.

در حال حاضر ، کاربران می توانند از وب سایت Gogs بازدید کنند http://gogs.example.com:3000. به منظور تسهیل دسترسی بازدید کنندگان ، به طوری که آنها دیگر نیازی به حضور ندارند :3000و امنیت سیستم را بهبود می بخشند. شما می توانید Nginx را به عنوان یک پروکسی معکوس نصب کرده و HTTPS را با استفاده از گواهی Letry Encrypt SSL فعال کنید.

توجه: اگرچه دستورالعمل های دو مرحله زیر اختیاری است ، اما انجام همه این دستورالعمل ها برای فعال کردن امنیت HTTPS بسیار توصیه می شود.

مرحله 4 (اختیاری): دریافت یک گواهی Letry Encrypt SSL کنید

عدم دسترسی به درگاه 3000:

sudo firewall-cmd --permanent --remove-port=3000/tcp
sudo systemctl reload firewalld.service

برنامه Certbot را نصب کنید:

sudo yum -y install yum-utils
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
sudo yum install -y certbot

برای گواهی Letry Encrypt SSL برای دامنه درخواست کنید gogs.example.com:

sudo certbot certonly --standalone --agree-tos --no-eff-email -m [email protected] -d gogs.example.com

گواهی و زنجیره به شرح زیر ذخیره می شود:

/etc/letsencrypt/live/gogs.example.com/fullchain.pem

پرونده اصلی در اینجا ذخیره می شود:

/etc/letsencrypt/live/gogs.example.com/privkey.pem

به طور پیش فرض ، گواهی Let Encrypt SSL طی سه ماه منقضی می شود. برای تجدید خودکار گواهینامه های Letry Encrypt می توانید مانند کاری که در زیر انجام شده است ، تنظیم کنید:

sudo crontab -e

Iخط زیر را فشار داده و وارد کنید:

0 0,12 * * * python -c 'import random; import time; time.sleep(random.random() * 3600)' && certbot renew

ذخیره نموده و خارج شوید:

:wq!

این کار cron تلاش خواهد کرد که گواهی Let Encrypt را هر روز ظهر تمدید کند.

مرحله 5 (اختیاری): Nginx را به عنوان یک پروکسی معکوس نصب کنید

Nginx را با استفاده از repo EPEL YUM نصب کنید:

sudo yum install -y nginx

یک پرونده پیکربندی برای Gogs ایجاد کنید:

cat <<EOF | sudo tee /etc/nginx/conf.d/gogs.conf
# Redirect HTTP to HTTPS
server {
    listen      80;
    server_name gogs.example.com;
    return      301 https://\$server_name\$request_uri;
}

server {

    # Setup HTTPS certificates
    listen       443 default ssl;
    server_name  gogs.example.com;
    ssl_certificate      /etc/letsencrypt/live/gogs.example.com/fullchain.pem;
    ssl_certificate_key  /etc/letsencrypt/live/gogs.example.com/privkey.pem;

    # Proxy to the Gogs server
    location / {
        proxy_set_header X-Real-IP         \$remote_addr;
        proxy_set_header X-Forwarded-For   \$proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-Host  \$http_host;
        proxy_set_header Host              \$http_host;
        proxy_max_temp_file_size           0;
        proxy_pass                         http://127.0.0.1:3000;
        proxy_redirect                     http:// https://;
    }
}
EOF

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

sudo systemctl daemon-reload
sudo systemctl restart nginx.service
sudo systemctl enable nginx.service

در آخر ، مرورگر وب مورد علاقه خود را http://gogs.example.com/برای شروع کاوش در وب سایت Gogs خود نشان دهید. خواهید فهمید که پروتکل HTTPS بطور خودکار فعال می شود. به عنوان سرمربی که قبلاً تنظیم کردید وارد شوید یا حساب کاربری جدیدی را برای کارهای تیمی ثبت کنید.