نام (NAME)

firewalld.service - فایل‌های پیکربندی سرویس firewalld

خلاصه دستور (SYNOPSIS)

/etc/firewalld/services/service.xml
/usr/lib/firewalld/services/service.xml

توضیحات (DESCRIPTION)

یک فایل پیکربندی سرویس firewalld، اطلاعات مربوط به یک ورودی سرویس را برای firewalld فراهم می‌کند. مهم‌ترین گزینه‌های پیکربندی شامل پورت‌ها، ماژول‌ها و آدرس‌های مقصد هستند.

این فایل پیکربندی نمونه، ساختار یک فایل پیکربندی سرویس را نشان می‌دهد:

<?xml version="1.0" encoding="utf-8"?>
<service>
  <short>My Service</short>
  <description>description</description>
  <port port="137" protocol="tcp"/>
  <protocol value="igmp"/>
  <module name="nf_conntrack_netbios_ns"/>
  <destination ipv4="224.0.0.251" ipv6="ff02::fb"/>
  <include service="ssdp"/>
  <helper name="ftp"/>
</service>

گزینه‌ها (OPTIONS)

پیکربندی می‌تواند شامل این برچسب‌ها و مشخصه‌ها باشد. برخی از آن‌ها اجباری و برخی دیگر اختیاری هستند.

service

برچسب آغازین و پایانی اجباری service، سرویس را تعریف می‌کند. این برچسب تنها یک‌بار می‌تواند در یک فایل پیکربندی سرویس استفاده شود. مشخصه‌های اختیاری برای سرویس‌ها وجود دارد:

version="string"

برای اختصاص دادن یک نسخه به سرویس.

short

یک برچسب آغازین و پایانی اختیاری است و برای دادن نامی خواناتر به سرویس استفاده می‌شود.

description

یک برچسب آغازین و پایانی اختیاری برای ارائه توضیحات درباره سرویس است.

port

یک برچسب عنصر خالی اختیاری است و می‌تواند چندین بار برای داشتن بیش از یک ورودی پورت استفاده شود. تمام مشخصه‌های یک ورودی پورت اجباری هستند:

port="string"

رشته‌ی پورت string می‌تواند یک شماره پورت تکی یا یک محدوده پورت به‌صورت portid-portid باشد یا همچنین برای تطبیق تنها یک پروتکل، خالی گذاشته شود.

protocol="string"

مقدار پروتکل می‌تواند یکی از مقادیر tcp، udp، sctp یا dccp باشد.

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

protocol

یک برچسب عنصر خالی اختیاری است و می‌تواند چندین بار برای داشتن بیش از یک ورودی پروتکل استفاده شود. یک ورودی پروتکل دقیقاً دارای یک مشخصه است:

value="string"

پروتکل می‌تواند هر پروتکلی باشد که توسط سیستم پشتیبانی می‌شود. لطفاً برای مشاهده پروتکل‌های پشتیبانی‌شده به /etc/protocols نگاهی بیندازید.

source-port

یک برچسب عنصر خالی اختیاری است و می‌تواند چندین بار برای داشتن بیش از یک ورودی پورت مبدأ استفاده شود. تمام مشخصه‌های یک ورودی پورت مبدأ اجباری هستند:

port="string"

رشته پورت string می‌تواند یک شماره پورت تکی یا یک محدوده پورت به‌صورت portid-portid باشد.

protocol="string"

مقدار پروتکل می‌تواند یکی از مقادیر tcp، udp، sctp یا dccp باشد.

module

این عنصر منسوخ شده است. لطفاً از helper که در ادامه در بخش “helper” توضیح داده شده استفاده کنید.

destination

یک برچسب عنصر خالی اختیاری است و تنها یک‌بار می‌تواند استفاده شود. مقصد، شبکه مقصد را به عنوان یک آدرس IP شبکه (اختیاری همراه با mask/) یا یک آدرس IP ساده مشخص می‌کند. استفاده از نام‌های میزبان (hostnames) توصیه نمی‌شود، زیرا این نام‌ها تنها در زمان فعال‌سازی سرویس تحلیل شده و به هسته ارسال می‌شوند. برای اطلاعات بیشتر درباره این عنصر، لطفاً به --destination در iptables(8) و ip6tables(8) مراجعه کنید.

ipv4="address[/mask]"

آدرس مقصد IPv4 به همراه ماسک اختیاری.

ipv6="address[/mask]"

آدرس مقصد IPv6 به همراه ماسک اختیاری.