<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[Negarnovin Engineering]]></title><description><![CDATA[Technical articles and practical infrastructure guides from Negarnovin, an Iran-based cloud infrastructure and IT services provider.]]></description><link>https://negarnovin.hashnode.dev</link><generator>RSS for Node</generator><lastBuildDate>Wed, 18 Nov 2026 13:14:53 GMT</lastBuildDate><atom:link href="https://negarnovin.hashnode.dev/rss.xml" rel="self" type="application/rss+xml"/><language><![CDATA[en]]></language><ttl>60</ttl><item><title><![CDATA[How to Troubleshoot Network Connectivity on an Ubuntu VPS After a Release Upgrade]]></title><description><![CDATA[A safe, step-by-step diagnostic workflow for interfaces, Netplan, routes, DNS, network managers and logs after a major Ubuntu upgrade.]]></description><link>https://negarnovin.hashnode.dev/how-to-troubleshoot-network-connectivity-on-an-ubuntu-vps-after-a-release-upgrade</link><guid isPermaLink="true">https://negarnovin.hashnode.dev/how-to-troubleshoot-network-connectivity-on-an-ubuntu-vps-after-a-release-upgrade</guid><category><![CDATA[Linux]]></category><category><![CDATA[Ubuntu]]></category><category><![CDATA[networking]]></category><category><![CDATA[Devops]]></category><category><![CDATA[vps]]></category><dc:creator><![CDATA[Saeed Naderi]]></dc:creator><pubDate>Sat, 31 Oct 2026 10:19:57 GMT</pubDate><content:encoded><![CDATA[<p># How to Troubleshoot Network Connectivity on an Ubuntu VPS After a Release Upgrade</p>
<p>A major Ubuntu release upgrade can leave a virtual machine booting normally while network connectivity is broken. The cause is not always the hypervisor or the provider network. Netplan configuration, the active renderer, interface names, address prefixes, routes, or DNS resolution may have changed during the upgrade.</p>
<p>The safest approach is to collect the current network state first, isolate the failing layer, and make one controlled change at a time. Avoid replacing the whole network configuration with a generic example: VPS providers can use different addressing models, including point-to-point and /32 configurations.</p>
<p>## 1. Keep a recovery path open</p>
<p>Before changing network settings over SSH, make sure you have access to the provider's web console, serial console, or another out-of-band recovery method.</p>
<p>Back up the current configuration:</p>
<p>```bash</p>
<p>sudo cp -a /etc/netplan "/root/netplan-backup-$(date +%F-%H%M%S)"</p>
<p>```</p>
<p>Do not reboot simply because DNS or ping tests fail. First capture the interface state, routes, and relevant logs. This evidence is useful if the issue needs to be escalated to the hosting provider.</p>
<p>## 2. Confirm the interface name and IP address</p>
<p>Start with:</p>
<p>```bash</p>
<p>ip -br link</p>
<p>ip -br address</p>
<p>```</p>
<p>Identify the interface that should carry the public address. Do not assume that it is called `eth0`. Virtual machines may use names such as `ens3`, `ens18`, `ens160`, or `ens192`.</p>
<p>Check that:</p>
<p>- The expected interface exists.</p>
<p>- The interface is administratively UP.</p>
<p>- The assigned address and prefix match the provider's network information.</p>
<p>- The address is attached to the intended interface.</p>
<p>If the interface name changed, an old Netplan match rule may no longer select the device.</p>
<p>## 3. Inspect the routing table before changing DNS</p>
<p>Run:</p>
<p>```bash</p>
<p>ip route</p>
<p>ip rule</p>
<p>```</p>
<p>Look for a default route and confirm that its gateway and outgoing interface match the provider's network design.</p>
<p>A common mistake is copying a gateway from another server or assuming that every VPS uses a conventional subnet. Some providers assign a /32 address and require an explicit route to reach the gateway. Guessing a gateway or prefix can make the machine unreachable.</p>
<p>If the default route is missing, do not invent a replacement. Compare the current configuration with the provider's provisioning information or network panel.</p>
<p>## 4. Separate IP connectivity from DNS</p>
<p>Test connectivity to a public IP:</p>
<p>```bash</p>
<p>ping -c 4 1.1.1.1</p>
<p>```</p>
<p>Then inspect name resolution:</p>
<p>```bash</p>
<p>resolvectl status</p>
<p>resolvectl query ubuntu.com</p>
<p>```</p>
<p>Interpret the results carefully:</p>
<p>- If IP connectivity works but domain names fail, investigate DNS.</p>
<p>- If both IP connectivity and DNS fail, investigate the interface, address, route, gateway, firewall, and upstream network.</p>
<p>- If ping fails, remember that ICMP can be filtered or rate-limited. A failed ping alone does not prove that all TCP traffic is unavailable.</p>
<p>You can compare with a TCP test to a known service port:</p>
<p>```bash</p>
<p>curl -I --connect-timeout 5 <a href="https://example.com/">https://example.com/</a></p>
<p>```</p>
<p>## 5. Identify which service manages the interface</p>
<p>Ubuntu Server commonly uses Netplan as the configuration layer. The renderer may be systemd-networkd or NetworkManager.</p>
<p>Check the active services:</p>
<p>```bash</p>
<p>systemctl is-active systemd-networkd</p>
<p>systemctl is-active NetworkManager</p>
<p>networkctl list</p>
<p>nmcli device status</p>
<p>```</p>
<p>Do not configure the same interface independently through multiple network managers. Determine which service owns the interface before editing configuration.</p>
<p>## 6. Review Netplan without applying changes immediately</p>
<p>List the configuration files and inspect the merged configuration:</p>
<p>```bash</p>
<p>ls -l /etc/netplan/</p>
<p>sudo netplan get</p>
<p>```</p>
<p>Review the YAML for:</p>
<p>- Correct interface names or match rules.</p>
<p>- Address and prefix.</p>
<p>- Default route and gateway.</p>
<p>- DNS nameservers.</p>
<p>- Renderer selection.</p>
<p>- YAML indentation.</p>
<p>Validate the generated configuration:</p>
<p>```bash</p>
<p>sudo netplan generate</p>
<p>```</p>
<p>If the syntax is valid and you have out-of-band console access, use the rollback-capable test mode:</p>
<p>```bash</p>
<p>sudo netplan try</p>
<p>```</p>
<p>Confirm only after you have tested connectivity. Applying an incorrect network configuration over SSH can disconnect the session.</p>
<p>## 7. Check system logs and interface counters</p>
<p>Collect network service logs:</p>
<p>```bash</p>
<p>sudo journalctl -b -u systemd-networkd --no-pager -n 100</p>
<p>sudo journalctl -b -u NetworkManager --no-pager -n 100</p>
<p>```</p>
<p>Search kernel messages for device and driver events:</p>
<p>```bash</p>
<p>sudo journalctl -k -b --no-pager | grep -Ei 'virtio|network|link is|rename|driver'</p>
<p>```</p>
<p>Inspect interface counters:</p>
<p>```bash</p>
<p>ip -s link</p>
<p>```</p>
<p>Compare counters over time. A single snapshot cannot show whether errors or drops are increasing.</p>
<p>## 8. Make the smallest possible correction</p>
<p>Once the failing layer is known, change only the relevant setting. Examples include correcting an interface match rule, restoring a provider-supplied route, or fixing the resolver configuration.</p>
<p>Avoid these shortcuts:</p>
<p>- Flushing all firewall rules as a first response.</p>
<p>- Replacing the entire Netplan directory with a generic template.</p>
<p>- Restarting every networking service simultaneously.</p>
<p>- Guessing an IP prefix or gateway.</p>
<p>- Rebooting before collecting diagnostic output.</p>
<p>- Applying changes without a recovery console.</p>
<p>Keep the backup until the server has passed connectivity tests and has survived a controlled reboot.</p>
<p>## 9. Prepare a useful support report</p>
<p>If the issue remains unresolved, provide the hosting provider with:</p>
<p>1. Ubuntu release and upgrade date.</p>
<p>2. Virtualization platform, if known.</p>
<p>3. Interface names and assigned address/prefix.</p>
<p>4. Output of `ip route` and `ip rule`.</p>
<p>5. Active network renderer.</p>
<p>6. Relevant service and kernel logs.</p>
<p>7. Results of IP, DNS, and TCP connectivity tests.</p>
<p>8. Whether the problem affects inbound traffic, outbound traffic, or both.</p>
<p>Redact passwords, tokens, private keys, and customer data before sharing logs publicly.</p>
<p>## Closing notes</p>
<p>Network recovery after an Ubuntu release upgrade is a diagnosis task, not a reason to apply a generic network template. Preserve the provider-specific addressing model, identify the active network manager, and validate one change at a time.</p>
<p>For more information about Negarnovin's infrastructure services, visit [Negarnovin](<a href="https://negarnovin.com/">https://negarnovin.com/</a>) or review the [VPS service catalogue](<a href="https://negarnovin.com/vps/">https://negarnovin.com/vps/</a>). Additional engineering notes are available in the [Negarnovin technical repository](<a href="https://github.com/engsaeednaderi/negarnovin/tree/main/technical-guides">https://github.com/engsaeednaderi/negarnovin/tree/main/technical-guides</a>).</p>
<p>This guide is informational. Always validate network changes against the specific Ubuntu release and the network documentation supplied for your VPS.</p>
]]></content:encoded></item><item><title><![CDATA[آموزش Nginx به صورت رایگان]]></title><description><![CDATA[اگر با سرور لینوکس، میزبانی وب یا توسعه وب کار می‌کنید، احتمالاً نام Nginx را زیاد دیده‌اید. Nginx فقط یک Web Server ساده نیست؛ می‌توان از آن به‌عنوان…]]></description><link>https://negarnovin.hashnode.dev/nginx</link><guid isPermaLink="true">https://negarnovin.hashnode.dev/nginx</guid><dc:creator><![CDATA[Saeed Naderi]]></dc:creator><pubDate>Tue, 08 Sep 2026 09:48:54 GMT</pubDate><enclosure url="https://cdn.hashnode.com/uploads/covers/6a9fd81428aafc31b1465dd6/647b23b8-86ce-486a-8a76-8d9824537d7a.jpg" length="0" type="image/jpeg"/><content:encoded><![CDATA[<hr />
<h2>title: آموزش Nginx به صورت رایگان؛ نصب، تنظیمات، Reverse Proxy و افزایش امنیت published: true tags: nginx, linux, webdev, server</h2>
<h1>آموزش Nginx به صورت رایگان؛ از نصب تا Reverse Proxy</h1>
<p>اگر با سرور لینوکس، میزبانی وب یا توسعه وب کار می‌کنید، احتمالاً نام <strong>Nginx</strong> را زیاد دیده‌اید. Nginx فقط یک Web Server ساده نیست؛ می‌توان از آن به‌عنوان Reverse Proxy، Load Balancer، HTTP Cache و حتی Proxy برای برخی سرویس‌های دیگر استفاده کرد.</p>
<p>در این آموزش Nginx را از صفر شروع می‌کنیم و بدون نیاز به ابزارهای پیچیده، نصب، ساخت تنظیمات، اجرای یک سایت، Reverse Proxy، مدیریت سرویس و بررسی خطاها را یاد می‌گیریم.</p>
<p>برای انجام تمرین‌های این مقاله می‌توانید از یک سرور لینوکسی معمولی استفاده کنید. یک <a href="https://negarnovin.com/%D8%B3%D8%B1%D9%88%D8%B1-%D9%85%D8%AC%D8%A7%D8%B2%DB%8C-%D8%A7%DB%8C%D8%B1%D8%A7%D9%86/"><strong>سرور مجازی ایران</strong></a> هم می‌تواند محیط مناسبی برای راه‌اندازی آزمایشگاهی Nginx، سایت شخصی یا سرویس‌های داخلی باشد.</p>
<h2>Nginx چیست؟</h2>
<p>Nginx یک نرم‌افزار متن‌باز برای سرویس‌دهی HTTP و HTTPS است که می‌تواند نقش Web Server، Reverse Proxy، Load Balancer و Content Cache را ایفا کند. معماری Nginx مبتنی بر پردازش رویدادمحور است و معمولاً برای مدیریت تعداد زیادی اتصال هم‌زمان عملکرد مناسبی دارد.</p>
<p>یکی از مزیت‌های مهم Nginx این است که می‌توان یک سرور را به شکل‌های مختلف پیکربندی کرد. برای مثال:</p>
<ul>
<li><p>اجرای مستقیم فایل‌های HTML و CSS</p>
</li>
<li><p>قرار گرفتن جلوی یک برنامه Node.js</p>
</li>
<li><p>قرار گرفتن جلوی PHP-FPM</p>
</li>
<li><p>Reverse Proxy برای یک API</p>
</li>
<li><p>توزیع درخواست‌ها بین چند Backend</p>
</li>
<li><p>مدیریت چند دامنه روی یک IP</p>
</li>
<li><p>فعال‌سازی HTTPS</p>
</li>
</ul>
<p>راهنمای رسمی Nginx نیز همین کاربردها، از سرو محتوای استاتیک تا Proxy و FastCGI را پوشش می‌دهد.</p>
<hr />
<h2>نصب Nginx روی Ubuntu</h2>
<p>در این آموزش از Ubuntu و سیستم‌های مبتنی بر Debian استفاده می‌کنیم.</p>
<p>ابتدا فهرست پکیج‌ها را به‌روزرسانی کنید:</p>
<pre><code class="language-bash">sudo apt update
</code></pre>
<p>سپس Nginx را نصب کنید:</p>
<pre><code class="language-bash">sudo apt install nginx -y
</code></pre>
<p>بعد از نصب، وضعیت سرویس را بررسی کنید:</p>
<pre><code class="language-bash">sudo systemctl status nginx
</code></pre>
<p>اگر سرویس با موفقیت اجرا شده باشد، باید وضعیت <code>active (running)</code> را ببینید.</p>
<p>برای اطمینان بیشتر می‌توانید نسخه Nginx را نیز مشاهده کنید:</p>
<pre><code class="language-bash">nginx -v
</code></pre>
<hr />
<h2>اجرای خودکار Nginx بعد از Restart سرور</h2>
<p>در محیط واقعی، معمولاً می‌خواهیم Nginx بعد از راه‌اندازی مجدد سرور به‌صورت خودکار اجرا شود.</p>
<p>برای فعال‌کردن این قابلیت:</p>
<pre><code class="language-bash">sudo systemctl enable nginx
</code></pre>
<p>و برای شروع سرویس:</p>
<pre><code class="language-bash">sudo systemctl start nginx
</code></pre>
<p>دستورات اصلی مدیریت Nginx عبارت‌اند از:</p>
<pre><code class="language-bash">sudo systemctl start nginx
sudo systemctl stop nginx
sudo systemctl restart nginx
sudo systemctl reload nginx
</code></pre>
<p>تفاوت <code>reload</code> و <code>restart</code> مهم است. در زمان تغییر پیکربندی، معمولاً <code>reload</code> انتخاب مناسبی است، چون Nginx می‌تواند تنظیمات جدید را بدون قطع کامل سرویس اعمال کند. Nginx قبل از اعمال تنظیمات جدید نیز ساختار پیکربندی را بررسی می‌کند.</p>
<hr />
<h1>فایل تنظیمات Nginx کجاست؟</h1>
<p>در بیشتر نصب‌های Ubuntu، فایل اصلی تنظیمات این مسیر است:</p>
<pre><code class="language-text">/etc/nginx/nginx.conf
</code></pre>
<p>اما تمام تنظیمات الزاماً داخل همین فایل نوشته نمی‌شوند.</p>
<p>معمولاً ساختار دایرکتوری به شکل زیر است:</p>
<pre><code class="language-text">/etc/nginx/
├── nginx.conf
├── sites-available/
├── sites-enabled/
├── conf.d/
├── snippets/
├── mime.types
└── modules-enabled/
</code></pre>
<p>فایل <code>nginx.conf</code> تنظیمات اصلی را در خود دارد و فایل‌های دیگر می‌توانند از طریق <code>include</code> وارد ساختار تنظیمات شوند.</p>
<p>برای مشاهده تنظیمات اصلی:</p>
<pre><code class="language-bash">sudo nano /etc/nginx/nginx.conf
</code></pre>
<hr />
<h1>ساخت اولین سایت با Nginx</h1>
<p>فرض کنید می‌خواهیم یک سایت ساده را روی دامنه <code>example.com</code> اجرا کنیم.</p>
<p>ابتدا یک مسیر برای فایل‌های سایت ایجاد می‌کنیم:</p>
<pre><code class="language-bash">sudo mkdir -p /var/www/example.com/html
</code></pre>
<p>سپس یک فایل HTML بسازید:</p>
<pre><code class="language-bash">sudo nano /var/www/example.com/html/index.html
</code></pre>
<p>محتوای زیر را داخل آن قرار دهید:</p>
<pre><code class="language-html">&lt;!DOCTYPE html&gt;
&lt;html lang="fa"&gt;
&lt;head&gt;
    &lt;meta charset="UTF-8"&gt;
    &lt;title&gt;Nginx Test&lt;/title&gt;
&lt;/head&gt;
&lt;body&gt;
    &lt;h1&gt;Nginx is working!&lt;/h1&gt;
    &lt;p&gt;این صفحه توسط Nginx سرو می‌شود.&lt;/p&gt;
&lt;/body&gt;
&lt;/html&gt;
</code></pre>
<p>حالا باید یک Server Block برای دامنه ایجاد کنیم.</p>
<hr />
<h1>Server Block در Nginx چیست؟</h1>
<p>در Nginx مفهومی شبیه Virtual Host در برخی Web Serverهای دیگر وجود دارد که در Ubuntu معمولاً با نام <strong>Server Block</strong> شناخته می‌شود.</p>
<p>فایل زیر را ایجاد کنید:</p>
<pre><code class="language-bash">sudo nano /etc/nginx/sites-available/example.com
</code></pre>
<p>و این تنظیمات را قرار دهید:</p>
<pre><code class="language-nginx">server {
    listen 80;
    listen [::]:80;

    server_name example.com www.example.com;

    root /var/www/example.com/html;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}
</code></pre>
<p>در این تنظیمات:</p>
<p><code>listen 80</code> مشخص می‌کند Nginx روی پورت HTTP شماره 80 درخواست‌ها را دریافت کند.</p>
<p><code>server_name</code> دامنه‌هایی را مشخص می‌کند که این Server Block باید برای آن‌ها استفاده شود.</p>
<p><code>root</code> مسیر فایل‌های سایت را تعیین می‌کند.</p>
<p><code>index</code> فایل پیش‌فرض هنگام دسترسی به ریشه سایت را مشخص می‌کند.</p>
<p><code>location /</code> نیز رفتار درخواست‌های ورودی را تعریف می‌کند.</p>
<hr />
<h1>فعال کردن سایت</h1>
<p>صرفاً ساختن فایل داخل <code>sites-available</code> کافی نیست. باید آن را فعال کنیم.</p>
<p>دستور زیر را اجرا کنید:</p>
<pre><code class="language-bash">sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
</code></pre>
<p>سپس قبل از Reload کردن Nginx، حتماً Syntax تنظیمات را بررسی کنید:</p>
<pre><code class="language-bash">sudo nginx -t
</code></pre>
<p>اگر همه‌چیز درست باشد، خروجی مشابه زیر مشاهده می‌کنید:</p>
<pre><code class="language-text">syntax is ok
test is successful
</code></pre>
<p>حالا تنظیمات را اعمال کنید:</p>
<pre><code class="language-bash">sudo systemctl reload nginx
</code></pre>
<p>در این مرحله اگر DNS دامنه به IP سرور اشاره کند، سایت باید روی دامنه در دسترس باشد.</p>
<hr />
<h1>دستور مهم nginx -t</h1>
<p>یکی از مهم‌ترین دستورهایی که هنگام کار با Nginx باید یاد بگیرید:</p>
<pre><code class="language-bash">sudo nginx -t
</code></pre>
<p>این دستور قبل از Reload یا Restart به شما کمک می‌کند متوجه شوید Syntax فایل‌های تنظیمات صحیح است یا خیر.</p>
<p>مثلاً اگر یک <code>;</code> را فراموش کرده باشید، احتمالاً Nginx خطا را در همین مرحله اعلام می‌کند.</p>
<p>بنابراین به‌جای اینکه مستقیماً بعد از هر تغییر این دستور را بزنید:</p>
<pre><code class="language-bash">sudo systemctl restart nginx
</code></pre>
<p>بهتر است ابتدا:</p>
<pre><code class="language-bash">sudo nginx -t
</code></pre>
<p>و سپس:</p>
<pre><code class="language-bash">sudo systemctl reload nginx
</code></pre>
<p>را اجرا کنید.</p>
<hr />
<h1>Reverse Proxy چیست؟</h1>
<p>یکی از کاربردهای مهم Nginx، قرار گرفتن جلوی یک برنامه دیگر است.</p>
<p>فرض کنید یک برنامه Node.js روی پورت <code>3000</code> در حال اجراست:</p>
<pre><code class="language-text">Application
127.0.0.1:3000
</code></pre>
<p>کاربر نباید لزوماً مستقیماً به پورت 3000 متصل شود. می‌توان Nginx را روی پورت 80 یا 443 قرار داد و درخواست‌ها را به برنامه اصلی ارسال کرد.</p>
<p>ساختار کلی به این شکل خواهد بود:</p>
<pre><code class="language-text">User
  |
  v
Nginx
  |
  v
Application :3000
</code></pre>
<p>در این حالت Nginx نقش Reverse Proxy را دارد.</p>
<hr />
<h1>تنظیم Nginx برای Reverse Proxy</h1>
<p>یک Server Block مانند نمونه زیر ایجاد کنید:</p>
<pre><code class="language-nginx">server {
    listen 80;

    server_name example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;

        proxy_set_header Host $host;
        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 $scheme;
    }
}
</code></pre>
<p>مهم‌ترین خط این بخش:</p>
<pre><code class="language-nginx">proxy_pass http://127.0.0.1:3000;
</code></pre>
<p>است.</p>
<p>یعنی Nginx درخواست دریافت‌شده را به برنامه‌ای که روی پورت 3000 در حال اجراست منتقل می‌کند.</p>
<p>Nginx به‌صورت رسمی قابلیت Proxy را پشتیبانی می‌کند و در راهنمای خود نیز نمونه‌ای از <code>proxy_pass</code> ارائه کرده است.</p>
<hr />
<h1>Nginx برای PHP چگونه کار می‌کند؟</h1>
<p>Nginx به‌تنهایی PHP را اجرا نمی‌کند.</p>
<p>معمولاً برای اجرای PHP در کنار Nginx از <strong>PHP-FPM</strong> استفاده می‌شود.</p>
<p>معماری به شکل زیر است:</p>
<pre><code class="language-text">Browser
   |
   v
Nginx
   |
   v
PHP-FPM
   |
   v
PHP Application
</code></pre>
<p>در این حالت Nginx درخواست فایل‌های PHP را به PHP-FPM منتقل می‌کند.</p>
<p>یک نمونه تنظیمات رایج:</p>
<pre><code class="language-nginx">location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
</code></pre>
<p>البته نام Socket باید با نسخه PHP نصب‌شده روی سرور شما مطابقت داشته باشد.</p>
<p>برای مشاهده Socketهای PHP:</p>
<pre><code class="language-bash">ls /run/php/
</code></pre>
<hr />
<h1>بررسی لاگ‌های Nginx</h1>
<p>وقتی یک سایت یا Reverse Proxy مشکل دارد، اولین جایی که باید بررسی کنید لاگ‌ها هستند.</p>
<p>مسیر رایج لاگ‌ها:</p>
<pre><code class="language-text">/var/log/nginx/access.log
/var/log/nginx/error.log
</code></pre>
<p>برای مشاهده آخرین خطاها:</p>
<pre><code class="language-bash">sudo tail -f /var/log/nginx/error.log
</code></pre>
<p>و برای مشاهده درخواست‌های ورودی:</p>
<pre><code class="language-bash">sudo tail -f /var/log/nginx/access.log
</code></pre>
<p>مثلاً اگر Backend از دسترس خارج شده باشد، ممکن است در <code>error.log</code> خطاهایی مثل <code>connection refused</code> مشاهده کنید.</p>
<p>راهنمای رسمی Nginx نیز بررسی <code>access.log</code> و <code>error.log</code> را به‌عنوان یکی از راه‌های عیب‌یابی معرفی می‌کند.</p>
<hr />
<h1>تغییر پورت Nginx</h1>
<p>به‌صورت پیش‌فرض، HTTP روی پورت 80 اجرا می‌شود.</p>
<p>مثلاً می‌توان Server Block را به این شکل تغییر داد:</p>
<pre><code class="language-nginx">server {
    listen 8080;

    server_name example.com;

    root /var/www/example.com/html;
    index index.html;
}
</code></pre>
<p>بعد از ذخیره فایل:</p>
<pre><code class="language-bash">sudo nginx -t
</code></pre>
<p>و سپس:</p>
<pre><code class="language-bash">sudo systemctl reload nginx
</code></pre>
<p>اما اگر فایروال فعال باشد، باید پورت جدید را نیز در فایروال مجاز کنید.</p>
<hr />
<h1>اجازه دادن به HTTP و HTTPS در UFW</h1>
<p>اگر از UFW استفاده می‌کنید، می‌توانید HTTP و HTTPS را با دستور زیر فعال کنید:</p>
<pre><code class="language-bash">sudo ufw allow 'Nginx Full'
</code></pre>
<p>برای مشاهده قوانین فعلی:</p>
<pre><code class="language-bash">sudo ufw status
</code></pre>
<p>اگر فقط HTTP لازم دارید:</p>
<pre><code class="language-bash">sudo ufw allow 'Nginx HTTP'
</code></pre>
<p>و برای HTTPS:</p>
<pre><code class="language-bash">sudo ufw allow 'Nginx HTTPS'
</code></pre>
<hr />
<h1>فعال کردن HTTPS</h1>
<p>در محیط Production بهتر است سرویس‌های عمومی با HTTPS ارائه شوند.</p>
<p>برای این کار معمولاً از گواهی TLS استفاده می‌شود. در اکوسیستم لینوکس، ترکیب Nginx و Let's Encrypt یکی از روش‌های رایج برای فعال‌سازی HTTPS است.</p>
<p>بعد از فعال شدن HTTPS، ساختار سرویس تقریباً به این صورت خواهد بود:</p>
<pre><code class="language-text">Client
  |
 HTTPS :443
  |
  v
Nginx
  |
  v
Backend
</code></pre>
<p>در پروژه‌های واقعی، Nginx می‌تواند وظایفی مانند Termination اتصال TLS، Reverse Proxy و مسیریابی درخواست‌ها را بر عهده بگیرد.</p>
<hr />
<h1>چند تنظیم کاربردی Nginx برای Production</h1>
<p>وقتی Nginx را روی سرور واقعی اجرا می‌کنید، صرفاً بالا آمدن صفحه کافی نیست. بهتر است تنظیمات را متناسب با سرویس خود بررسی کنید.</p>
<p>برای مثال:</p>
<pre><code class="language-nginx">server_tokens off;
</code></pre>
<p>می‌تواند نمایش نسخه Nginx در برخی پاسخ‌های خطا را محدود کند.</p>
<p>برای فعال کردن فشرده‌سازی:</p>
<pre><code class="language-nginx">gzip on;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml;
</code></pre>
<p>برای فایل‌های Static نیز می‌توان Cache-Control تعریف کرد:</p>
<pre><code class="language-nginx">location ~* \.(jpg|jpeg|png|gif|css|js|svg|webp)$ {
    expires 7d;
    add_header Cache-Control "public";
}
</code></pre>
<p>البته تنظیمات Cache باید متناسب با نوع سایت انجام شود. اگر فایل‌های CSS و JavaScript با محتوای جدید بدون تغییر نام یا نسخه منتشر می‌شوند، Cache طولانی می‌تواند باعث نمایش نسخه قدیمی در مرورگر شود.</p>
<hr />
<h1>استفاده از Nginx روی VPS</h1>
<p>Nginx روی منابع سخت‌افزاری مختلف قابل اجراست و برای بسیاری از پروژه‌های کوچک و متوسط نیازی به سرور بسیار قدرتمند ندارد.</p>
<p>برای یادگیری و تست می‌توانید یک VPS لینوکسی تهیه کنید و تمام مراحل این مقاله را روی آن اجرا کنید. مثلاً یک <a href="https://negarnovin.com/%D8%B3%D8%B1%D9%88%D8%B1-%D9%85%D8%AC%D8%A7%D8%B2%DB%8C-%D8%A7%DB%8C%D8%B1%D8%A7%D9%86/"><strong>سرور مجازی ایران</strong></a> برای آزمایش تنظیمات Nginx، اجرای Web Server، Reverse Proxy یا سرویس‌های داخلی گزینه‌ای عملی است.</p>
<p>البته در محیط Production فقط CPU و RAM مهم نیستند. نوع دیسک، کیفیت شبکه، پایداری اتصال، تنظیمات فایروال، سیستم‌عامل و معماری برنامه نیز روی نتیجه نهایی تأثیر دارند.</p>
<hr />
<h1>عیب‌یابی مشکلات رایج Nginx</h1>
<h2>خطای 502 Bad Gateway</h2>
<p>اگر از Reverse Proxy استفاده می‌کنید و با خطای:</p>
<pre><code class="language-text">502 Bad Gateway
</code></pre>
<p>مواجه شدید، ابتدا Backend را بررسی کنید.</p>
<p>برای مثال اگر برنامه باید روی پورت 3000 اجرا شود:</p>
<pre><code class="language-bash">curl http://127.0.0.1:3000
</code></pre>
<p>اگر برنامه پاسخ ندهد، مشکل احتمالاً در Backend است، نه در Nginx.</p>
<p>بعد لاگ را بررسی کنید:</p>
<pre><code class="language-bash">sudo tail -50 /var/log/nginx/error.log
</code></pre>
<hr />
<h2>خطای 403 Forbidden</h2>
<p>خطای 403 معمولاً می‌تواند به مجوزهای فایل و دایرکتوری یا تنظیمات Nginx مربوط باشد.</p>
<p>ابتدا وضعیت فایل‌ها را بررسی کنید:</p>
<pre><code class="language-bash">ls -lah /var/www/example.com/html
</code></pre>
<p>همچنین مطمئن شوید Nginx به مسیر موردنظر دسترسی دارد.</p>
<hr />
<h2>خطای 404 Not Found</h2>
<p>اگر Nginx فایل موردنظر را پیدا نمی‌کند، مقدار <code>root</code> و ساختار URL را بررسی کنید:</p>
<pre><code class="language-nginx">root /var/www/example.com/html;
</code></pre>
<p>بعد مطمئن شوید فایل واقعاً در همین مسیر وجود دارد:</p>
<pre><code class="language-bash">ls -lah /var/www/example.com/html
</code></pre>
<hr />
<h1>بررسی کامل تنظیمات Nginx</h1>
<p>برای نمایش نسخه:</p>
<pre><code class="language-bash">nginx -v
</code></pre>
<p>برای تست Syntax:</p>
<pre><code class="language-bash">sudo nginx -t
</code></pre>
<p>برای نمایش تنظیمات Compile شده:</p>
<pre><code class="language-bash">nginx -V
</code></pre>
<p>برای مشاهده وضعیت سرویس:</p>
<pre><code class="language-bash">sudo systemctl status nginx
</code></pre>
<p>و برای مشاهده لاگ سرویس:</p>
<pre><code class="language-bash">sudo journalctl -u nginx
</code></pre>
<p>این چند دستور در زمان عیب‌یابی بسیار کاربردی هستند.</p>
<hr />
<h1>نکات امنیتی مهم برای Nginx</h1>
<p>راه‌اندازی Web Server فقط نصب نرم‌افزار نیست. چند نکته ساده می‌تواند سطح امنیت سرویس را بهتر کند.</p>
<p>اول، سیستم‌عامل را به‌روز نگه دارید:</p>
<pre><code class="language-bash">sudo apt update
sudo apt upgrade
</code></pre>
<p>دوم، سرویس‌های غیرضروری را روی اینترنت عمومی باز نگذارید.</p>
<p>سوم، Backend را ترجیحاً روی <code>127.0.0.1</code> اجرا کنید، مگر اینکه واقعاً نیاز داشته باشید از شبکه دیگری مستقیماً به آن متصل شوید.</p>
<p>مثلاً:</p>
<pre><code class="language-text">127.0.0.1:3000
</code></pre>
<p>برای بسیاری از کاربردهای Reverse Proxy مناسب‌تر از این است:</p>
<pre><code class="language-text">0.0.0.0:3000
</code></pre>
<p>همچنین Ruleهای فایروال را دقیق بررسی کنید و فقط پورت‌هایی را باز بگذارید که واقعاً موردنیاز هستند.</p>
<hr />
<h1>جمع‌بندی دستورات مهم Nginx</h1>
<p>اگر بخواهیم مهم‌ترین دستورات این آموزش را یکجا داشته باشیم:</p>
<pre><code class="language-bash"># نصب
sudo apt update
sudo apt install nginx -y

# وضعیت سرویس
sudo systemctl status nginx

# شروع
sudo systemctl start nginx

# توقف
sudo systemctl stop nginx

# راه‌اندازی مجدد
sudo systemctl restart nginx

# اعمال تنظیمات جدید
sudo systemctl reload nginx

# بررسی تنظیمات
sudo nginx -t

# نمایش نسخه
nginx -v

# مشاهده لاگ خطا
sudo tail -f /var/log/nginx/error.log

# مشاهده لاگ درخواست‌ها
sudo tail -f /var/log/nginx/access.log
</code></pre>
<h2>مسیر یادگیری بعدی Nginx</h2>
<p>بعد از یادگیری مباحث این مقاله، بهتر است سراغ مفاهیم زیر بروید:</p>
<ol>
<li><p>Reverse Proxy پیشرفته</p>
</li>
<li><p>Load Balancing</p>
</li>
<li><p>HTTPS و TLS</p>
</li>
<li><p>PHP-FPM</p>
</li>
<li><p>Cache در Nginx</p>
</li>
<li><p>Rate Limiting</p>
</li>
<li><p>امنیت Headerها</p>
</li>
<li><p>مدیریت چندین دامنه</p>
</li>
<li><p>Nginx در Docker</p>
</li>
<li><p>Nginx در معماری Microservices</p>
</li>
</ol>
<p>وقتی این مفاهیم را روی یک سرور واقعی تمرین کنید، Nginx خیلی سریع از یک فایل تنظیمات مبهم به ابزاری قابل‌کنترل برای مدیریت ترافیک تبدیل می‌شود. برای محیط‌های آزمایشی و سرویس‌های داخلی نیز می‌توانید از یک <a href="https://negarnovin.com/%D8%B3%D8%B1%D9%88%D8%B1-%D9%85%D8%AC%D8%A7%D8%B2%DB%8C-%D8%A7%DB%8C%D8%B1%D8%A7%D9%86/"><strong>سرور مجازی ایران</strong></a> استفاده کنید و تنظیمات مختلف را بدون نیاز به خرید سرور اختصاصی تست کنید.</p>
<p>برای مطالعه بیشتر، مستندات رسمی Nginx نیز مرجع مناسبی برای بررسی Directiveها، Server Name، Reverse Proxy، HTTPS و سایر قابلیت‌های این وب‌سرور است: <a href="https://nginx.org/en/docs/">https://nginx.org/en/docs/</a></p>
<p><a href="https://negarnovin.com"><strong>https://negarnovin.com</strong></a></p>
]]></content:encoded></item></channel></rss>