TrueNAS доступ к папкам: полное руководство по настройке и управлению

# Путь в веб-интерфейсе:
# Credentials → Local Users → Add
# Credentials → Local Groups → Add

# Пример создания через CLI (если предпочитаешь терминал):
sudo midclt call user.create '{
  "username": "dev_user",
  "full_name": "Developer User",
  "password": "secure_password_123",
  "group_create": true,
  "groups": [1001]
}'

sudo midclt call group.create '{
  "name": "developers",
  "gid": 1001
}'

# Storage → Pools → три точки у пула → Add Dataset

# Параметры датасета:
Name: project_alpha
Comments: Основной проект Alpha

# ACL Type: NFSv4 (рекомендуется для смешанных сред)
# Case Sensitivity: Sensitive (для разработки)
# Share Type: Generic

# После создания нажимаем на три точки → Edit Permissions

# Sharing → Windows Shares (SMB) → Add

# Basic параметры:
Path: /mnt/pool_name/project_alpha
Name: project_alpha
Purpose: No presets (выбираем Default для полного контроля)

# Advanced параметры:
Auxiliary Parameters: # Дополнительные настройки Samba
  veto files = /.git/.idea/.vscode/ # Скрываем служебные папки
  delete veto files = yes
  hide dot files = yes
  guest ok = no # Запрещаем гостевой доступ
  valid users = @developers @admins
  write list = @developers @admins
  read list = @media_users

# Проверяем конфиг Samba
testparm -s

# Смотрим активные подключения
smbstatus

# Перезагружаем SMB службу
sudo midclt call service.restart 'cifs'

# Sharing → Unix Shares (NFS) → Add

# Параметры:
Path: /mnt/pool_name/project_alpha

# Networks: 192.168.1.0/24 (или конкретные IP)
# Authorized Networks: 192.168.1.0/24

# Mapall User: root (или специальный пользователь)
# Mapall Group: admins

# Security: sys (для локальной сети)
# Enabled NFSv4: ✓

# Устанавливаем NFS клиент
sudo apt install nfs-common  # Debian/Ubuntu
sudo yum install nfs-utils   # RHEL/CentOS

# Создаем точку монтирования
sudo mkdir -p /mnt/nas/project_alpha

# Монтируем NFS шару
sudo mount -t nfs -o vers=4.2,rw,hard,intr \
  192.168.1.100:/mnt/pool_name/project_alpha \
  /mnt/nas/project_alpha

# Для автоматического монтирования при загрузке
# Добавляем в /etc/fstab:
192.168.1.100:/mnt/pool_name/project_alpha  /mnt/nas/project_alpha  nfs  vers=4.2,rw,hard,intr,noauto,x-systemd.automount  0  0

# Устанавливаем ACL через CLI
# Давай представим структуру:
# /project_alpha
#   /source_code    (только developers)
#   /builds         (developers + CI система)
#   /documentation  (все читают, только tech writers пишут)

# Устанавливаем наследуемые ACL для source_code
setfacl -R -m g:developers:rwx /mnt/pool_name/project_alpha/source_code
setfacl -R -d -m g:developers:rwx /mnt/pool_name/project_alpha/source_code

# Для builds даем доступ CI системе (отдельный пользователь)
setfacl -R -m u:ci_system:rwx /mnt/pool_name/project_alpha/builds
setfacl -R -d -m u:ci_system:rwx /mnt/pool_name/project_alpha/builds

# Смотрим текущие ACL
getfacl /mnt/pool_name/project_alpha/source_code

# 1. Проверяем базовые права
ls -la /mnt/pool_name/project_alpha

# 2. Смотрим ACL
getfacl /mnt/pool_name/project_alpha

# 3. Проверяем пользователя и группы
id username

# 4. Логи Samba
tail -f /var/log/samba4/log.smbd

# 5. Логи NFS
tail -f /var/log/messages | grep nfs

# 6. Проверяем сетевую доступность
ping 192.168.1.100
nc -zv 192.168.1.100 445  # SMB порт
nc -zv 192.168.1.100 2049 # NFS порт

# 7. Перезапускаем службы
sudo midclt call service.restart 'cifs'
sudo midclt call service.restart 'nfs'

import requests
import json

class TrueNASClient:
    def __init__(self, host, api_key):
        self.base_url = f"https://{host}/api/v2.0"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }
    
    def create_smb_share(self, path, name, comment=""):
        """Создание SMB шары"""
        data = {
            "path": path,
            "name": name,
            "comment": comment,
            "purpose": "DEFAULT_SHARE",
            "guestok": False,
            "abe": True  # Access Based Enumeration
        }
        
        response = requests.post(
            f"{self.base_url}/sharing/smb",
            headers=self.headers,
            data=json.dumps(data),
            verify=False  # для самоподписанных сертификатов
        )
        return response.json()
    
    def set_dataset_permissions(self, dataset_path, owner, group, mode="755"):
        """Настройка прав датасета"""
        data = {
            "path": dataset_path,
            "mode": mode,
            "user": owner,
            "group": group,
            "acl": [],
            "recursive": True
        }
        
        response = requests.post(
            f"{self.base_url}/filesystem/setperm",
            headers=self.headers,
            data=json.dumps(data)
        )
        return response.json()

# Использование
nas = TrueNASClient("192.168.1.100", "your-api-key-here")
result = nas.create_smb_share(
    path="/mnt/pool/project_alpha",
    name="project_alpha",
    comment="Automated share for developers"
)
print(f"Share created: {result}")