מדריך מלא: הגדרת תעודת נטפרי ב-Home Assistant (מכשיר ISG MAX - CPF1056)

מסמך זה מרכז את כלל הפקודות הסופיות והבדוקות להטמעת תעודת האבטחה של נטפרי והתאמת סביבת Python 3.14 ו-Home Assistant במכשיר ה-ISG MAX (בתוך קונטיינר ה-PRoot של ubuntu2604), למקרה של איפוס המכשיר או עדכון גרסה.

שלב 1: התחברות למכשיר ב-SSH

פתח את שורת הפקודה (CMD / PowerShell) במחשב והתחבר למכשיר בפורט 8022 (ללא ציון המשתמש root):

ssh 192.168.10.28 -p 8022


אימות: ודא שמופיעה הודעת הפתיחה Welcome to Termux! ושורת הפקודה ~ $.

שלב 2: הורדת תעודת נטפרי והזרקתה לכל המאגרים (Termux + Ubuntu + Python)

העתק והדבק את בלוק הפקודות הבא כדי להוריד את התעודה העדכנית משרת נטפרי ולהזריק אותה למאגר של Termux, למאגר של קונטיינר ה-Ubuntu (ubuntu2604) ולכל קובצי ה-cacert.pem של ספריית certifi:

curl -sL http://ca.netfree.link/netfree-ca.crt >> $PREFIX/etc/tls/cert.pem 2>/dev/null || true

cat $PREFIX/etc/tls/cert.pem >> /data/data/com.termux/files/usr/var/lib/proot-distro/containers/ubuntu2604/rootfs/etc/ssl/certs/ca-certificates.crt

for f in $(find $PREFIX/ -name "cacert.pem" 2>/dev/null); do cat $PREFIX/etc/tls/cert.pem >> "$f"; done


אימות: הרץ את הפקודה הבאה וודא שמופיעה השורה -----END CERTIFICATE-----:

tail -n 3 /data/data/com.termux/files/usr/var/lib/proot-distro/containers/ubuntu2604/rootfs/etc/ssl/certs/ca-certificates.crt


שלב 3: יצירת קובץ התיקון sitecustomize.py עבור Python 3.14

הפקודות הבאות מוחקות קישורים שבורים ויוצרות קובץ sitecustomize.py תקין שמגדיר את סדר האימות הנכון (check_hostname = False לפני CERT_NONE) מבלי לדרוס מחלקות ומבלי להקריס את Home Assistant:

mkdir -p /data/data/com.termux/files/usr/var/lib/proot-distro/containers/ubuntu2604/rootfs/etc/python3.14

rm -f /data/data/com.termux/files/usr/var/lib/proot-distro/containers/ubuntu2604/rootfs/usr/lib/python3.14/sitecustomize.py
rm -f /data/data/com.termux/files/usr/var/lib/proot-distro/containers/ubuntu2604/rootfs/opt/homeassistant/lib/python3.14/site-packages/sitecustomize.py

printf 'import ssl, os\nos.environ["PYTHONHTTPSVERIFY"] = "0"\n_orig = ssl.create_default_context\ndef _relaxed(*a, **kw):\n    c = _orig(*a, **kw)\n    c.check_hostname = False\n    c.verify_mode = ssl.CERT_NONE\n    return c\nssl.create_default_context = _relaxed\nssl._create_default_https_context = _relaxed\nprint("[NetFree SSL] Bypass Active")\n' > /data/data/com.termux/files/usr/var/lib/proot-distro/containers/ubuntu2604/rootfs/usr/lib/python3.14/sitecustomize.py

cp /data/data/com.termux/files/usr/var/lib/proot-distro/containers/ubuntu2604/rootfs/usr/lib/python3.14/sitecustomize.py /data/data/com.termux/files/usr/var/lib/proot-distro/containers/ubuntu2604/rootfs/etc/python3.14/sitecustomize.py
chmod 644 /data/data/com.termux/files/usr/var/lib/proot-distro/containers/ubuntu2604/rootfs/usr/lib/python3.14/sitecustomize.py /data/data/com.termux/files/usr/var/lib/proot-distro/containers/ubuntu2604/rootfs/etc/python3.14/sitecustomize.py


אימות: בדוק שחיבור HTTPS החוצה מתוך הקונטיינר עובד כראוי על ידי הרצת הפקודה:

proot-distro login ubuntu2604 -- /opt/homeassistant/bin/python3 -c "import urllib.request; print('Status:', urllib.request.urlopen('https://api.github.com').status)"


הפלט חייב להיות:

[NetFree SSL] Bypass Active
Status: 200


שלב 4: עדכון קובץ ה-SSL הפנימי של Home Assistant (util/ssl.py)

כדי שגם חיבורי aiohttp, עדכונים, אינטגרציות ו-HACS בתוך Home Assistant יעבדו באופן מלא ולא יעקפו את הגדרות הפייתון, הרץ את הבלוק הבא שמאתר אוטומטית את הקובץ homeassistant/util/ssl.py, שומר לו גיבוי (ssl.py.bak), ומזריק אליו את ההתאמה לנטפרי:

HA_SSL=$(find $PREFIX/ -path "*/homeassistant/util/ssl.py" 2>/dev/null | head -n 1)
cp "$HA_SSL" "${HA_SSL}.bak"

python3 -c '
import sys
p = sys.argv[1]
with open(p, "r") as f:
    code = f.read()
patch = """
# NetFree Patch
import ssl as _ssl
_orig_ha_ctx = client_context
def _nf_client_context(*a, **kw):
    c = _orig_ha_ctx(*a, **kw)
    c.check_hostname = False
    c.verify_mode = _ssl.CERT_NONE
    return c
client_context = _nf_client_context
create_no_verify_ssl_context = _nf_client_context
"""
if "# NetFree Patch" not in code:
    with open(p, "a") as f:
        f.write(patch)
print("Successfully patched:", p)
' "$HA_SSL"


אימות: ודא שמופיעה השורה Successfully patched: ... עם הנתיב לקובץ.

שלב 5: הפעלה מחדש של Home Assistant

פתח בדפדפן את ממשק הניהול של ה-ISG בכתובת: http://192.168.10.28:8098

בכרטיסיית עוזר/ת ביתי, לחץ על כפתור הפעלה מחדש.

אימות: המתן כדקה עד שהחיווי ישתנה ל"ריצה רגילה" (ירוק).

נספח שימושי: פקודות בקרה, אבחון ו-ZeroTier

צפייה בלוג השגיאות של Home Assistant בזמן אמת מתוך הטרמינל:

tail -n 50 $PREFIX/var/lib/homeassistant/home-assistant.log


בדיקה האם שגיאה מסוימת נובעת מחסימת אתר בנטפרי (שגיאה 418) או מתעודה:

grep -iE "ssl|cert|418|403|netfree|JSONDecodeError" $PREFIX/var/lib/homeassistant/home-assistant.log | tail -n 25


כלי הקלטת תעבורה של נטפרי (לבדיקת חסימות בזמן אמת מהמחשב):
https://netfree.link/app/#/tools/traffic-record