#!/usr/bin/env python3
"""Локальная панель управления Instagram через instagrapi.
Важно: это НЕ публичный мост для ChatGPT и не выдаёт ссылку для удалённого
управления. По умолчанию сервер привязан только к 127.0.0.1. Для запуска в
публичном Hugging Face Space явно задайте PUBLIC_MODE=1 и длинный пароль панели.
Пароль Instagram не сохраняется; зашифрованная сессия хранится отдельно от data.json
и не отправляется в Hugging Face.
Зависимости:
python -m pip install flask instagrapi huggingface_hub cryptography
Пример запуска (Linux/macOS):
export DASHBOARD_PASSWORD='длинный-случайный-пароль-для-панели'
export HF_TOKEN_READ='...' # необязательно, если data.json уже есть локально
export HF_TOKEN_WRITE='...' # необязательно; включает резервную копию в HF
python instagram_connector.py
Локально откройте: http://127.0.0.1:7860/admhosto
В Hugging Face Space панель доступна по адресу Space + /admhosto.
В Space режим определяется по SPACE_ID автоматически; если платформа не задаёт эту
переменную, добавьте Variable PUBLIC_MODE=1. Задайте Secret DASHBOARD_PASSWORD
(случайная строка минимум 16 символов); порт по умолчанию 7860.
Скрипт использует data.json и Hugging Face Dataset из исходного проекта.
Если включена HF_TOKEN_WRITE, в HF отправляется весь data.json — как и в исходном
приложении. Не включайте синхронизацию, пока не убедитесь, что репозиторий HF приватный.
Не запускайте этот файл одновременно с исходным приложением, пишущим в тот же data.json.
"""
from __future__ import annotations
import hmac
import ipaddress
import json
import logging
import os
import re
import secrets
import shutil
import sys
import tempfile
from importlib.metadata import PackageNotFoundError, version as package_version
import threading
import time
from collections import deque
from datetime import datetime, timedelta, timezone
from functools import wraps
from pathlib import Path
from typing import Any
from cryptography.fernet import Fernet, InvalidToken
from flask import (
Flask,
abort,
flash,
redirect,
render_template_string,
request,
session,
url_for,
)
from huggingface_hub import HfApi, hf_hub_download
from instagrapi import Client
# ---------- Настройки: совместимы с исходным data.json / HF Dataset ----------
BASE_DIR = Path(__file__).resolve().parent
def local_path(env_name: str, default_name: str) -> Path:
value = Path(os.environ.get(env_name, default_name)).expanduser()
return value if value.is_absolute() else BASE_DIR / value
DATA_FILE = local_path("DATA_FILE", "data.json")
SESSION_FILE = local_path("IG_SESSION_FILE", ".instagram_session.enc")
SESSION_KEY_FILE = local_path("IG_SESSION_KEY_FILE", ".instagram_session.key")
FLASK_SECRET_FILE = local_path("FLASK_SECRET_FILE", ".instagram_flask_secret")
REPO_ID = os.getenv("HF_REPO_ID", "flpolprojects/examplebonus")
HF_DATA_FILE_PATH = os.getenv("HF_DATA_FILE_PATH", "data.json")
HF_TOKEN_READ = os.getenv("HF_TOKEN_READ")
HF_TOKEN_WRITE = os.getenv("HF_TOKEN_WRITE")
ALLOW_HF_WRITE_WITHOUT_READ = os.getenv("ALLOW_HF_WRITE_WITHOUT_READ", "").strip().lower() in {"1", "true", "yes"}
_PUBLIC_MODE_ENV = os.getenv("PUBLIC_MODE")
# В Space используем публичный bind автоматически; локально по умолчанию localhost.
# Если платформа не задаёт SPACE_ID, задайте PUBLIC_MODE=1 вручную.
PUBLIC_MODE = (
bool(os.getenv("SPACE_ID"))
if _PUBLIC_MODE_ENV is None
else _PUBLIC_MODE_ENV.strip().lower() in {"1", "true", "yes"}
)
ADMIN_PATH = "/admhosto"
HOST = "0.0.0.0" if PUBLIC_MODE else "127.0.0.1"
PORT = int(os.getenv("PORT", "7860"))
DASHBOARD_PASSWORD = os.getenv("DASHBOARD_PASSWORD", "")
logging.basicConfig(
level=logging.INFO,
format="%(asctime)s %(levelname)s %(message)s",
)
# Не записываем тела запросов и не выводим пароли/коды в журнал.
logging.getLogger("werkzeug").setLevel(logging.WARNING)
_store_lock = threading.RLock()
_hf_upload_lock = threading.Lock()
_instagram_lock = threading.RLock()
_login_lock = threading.Lock()
_login_job_lock = threading.RLock()
_dm_lock = threading.Lock()
_LOGIN_JOBS: dict[str, dict[str, Any]] = {}
_ACTIVE_LOGIN_JOB_ID: str | None = None
STORE: dict[str, Any] = {"instagram_connector": {"audit": []}}
_HF_SYNC_SAFE = False
_ACTIVE_CLIENT: Client | None = None
_ACTIVE_USERNAME: str | None = None
_LAST_DM_TIME = 0.0
_LOGIN_FAILURES: deque[float] = deque()
# ---------- Безопасная запись файлов и JSON-хранилище ----------
def atomic_write(path: Path, content: bytes, mode: int = 0o600) -> None:
path.parent.mkdir(parents=True, exist_ok=True)
fd, temp_name = tempfile.mkstemp(prefix=f".{path.name}.", dir=str(path.parent))
try:
if hasattr(os, "fchmod"):
os.fchmod(fd, mode)
with os.fdopen(fd, "wb") as handle:
handle.write(content)
handle.flush()
os.fsync(handle.fileno())
os.replace(temp_name, path)
try:
os.chmod(path, mode)
except OSError:
pass
finally:
try:
if os.path.exists(temp_name):
os.unlink(temp_name)
except OSError:
pass
def download_data_from_hf_if_needed() -> bool:
"""Загружает базу из HF и возвращает True только при успешном скачивании."""
if DATA_FILE.exists() or not HF_TOKEN_READ:
return False
try:
logging.info("Локальной базы нет; пробую загрузить data.json из HF Dataset.")
downloaded = hf_hub_download(
repo_id=REPO_ID,
filename=HF_DATA_FILE_PATH,
repo_type="dataset",
token=HF_TOKEN_READ,
)
DATA_FILE.parent.mkdir(parents=True, exist_ok=True)
shutil.copyfile(downloaded, DATA_FILE)
try:
os.chmod(DATA_FILE, 0o600)
except OSError:
pass
return True
except Exception as exc:
# Не печатаем URL, токены или содержимое исключения.
logging.warning("Не удалось загрузить базу из HF (%s). Будет создана пустая.", type(exc).__name__)
return False
def load_store() -> None:
global STORE, _HF_SYNC_SAFE
if not DATA_FILE.exists():
download_data_from_hf_if_needed()
loaded: dict[str, Any] = {}
valid_local_data = False
if DATA_FILE.exists():
try:
with DATA_FILE.open("r", encoding="utf-8") as handle:
value = json.load(handle)
if isinstance(value, dict):
loaded = value
valid_local_data = True
else:
logging.warning("Корень data.json не является JSON-объектом; начну с пустого объекта.")
except Exception as exc:
logging.warning("Не удалось прочитать data.json (%s). Начну с пустого объекта.", type(exc).__name__)
else:
logging.info("data.json не найден; запись журнала отключена до успешной загрузки базы HF.")
# Не перезаписываем удалённую базу пустым JSON, если HF вернул 401/ошибку.
_HF_SYNC_SAFE = valid_local_data
if HF_TOKEN_WRITE and not _HF_SYNC_SAFE and not ALLOW_HF_WRITE_WITHOUT_READ:
logging.warning("HF-запись отключена: сначала исправьте HF_TOKEN_READ/доступ к репозиторию.")
connector = loaded.get("instagram_connector")
if not isinstance(connector, dict):
connector = {}
audit = connector.get("audit")
if not isinstance(audit, list):
connector["audit"] = []
loaded["instagram_connector"] = connector
with _store_lock:
STORE = loaded
def upload_data_to_hf() -> None:
"""Резервирует полный data.json тем же HF Dataset, что и исходный проект."""
if not HF_TOKEN_WRITE or not DATA_FILE.exists():
return
if not _HF_SYNC_SAFE and not ALLOW_HF_WRITE_WITHOUT_READ:
logging.warning("HF-upload пропущен: удалённая база не была прочитана; защищаю её от перезаписи пустым JSON.")
return
with _hf_upload_lock:
try:
HfApi().upload_file(
path_or_fileobj=str(DATA_FILE),
path_in_repo=HF_DATA_FILE_PATH,
repo_id=REPO_ID,
repo_type="dataset",
token=HF_TOKEN_WRITE,
commit_message=f"Update connector data {datetime.now(timezone.utc).strftime('%Y-%m-%d %H:%M:%S UTC')}",
)
logging.info("Резервная копия data.json отправлена в HF Dataset.")
except Exception as exc:
logging.warning("Не удалось отправить резервную копию в HF (%s).", type(exc).__name__)
def schedule_hf_upload() -> None:
if HF_TOKEN_WRITE:
threading.Thread(target=upload_data_to_hf, daemon=True).start()
def periodic_backup() -> None:
if not HF_TOKEN_WRITE:
return
while True:
time.sleep(3600)
upload_data_to_hf()
def record_event(action: str, success: bool) -> None:
"""Сохраняет только тип действия и результат — без текста сообщений и логинов."""
can_persist = _HF_SYNC_SAFE or ALLOW_HF_WRITE_WITHOUT_READ
with _store_lock:
connector = STORE.setdefault("instagram_connector", {})
if not isinstance(connector, dict):
connector = {}
STORE["instagram_connector"] = connector
audit = connector.setdefault("audit", [])
if not isinstance(audit, list):
audit = []
connector["audit"] = audit
audit.append(
{
"time": datetime.now(timezone.utc).isoformat(timespec="seconds"),
"action": action,
"success": bool(success),
}
)
del audit[:-300]
if can_persist:
content = json.dumps(STORE, ensure_ascii=False, indent=2).encode("utf-8")
atomic_write(DATA_FILE, content)
if can_persist:
schedule_hf_upload()
else:
logging.warning("Журнал не сохранён: база HF не загружена. Исправьте HF_TOKEN_READ и перезапустите Space.")
# ---------- Локальные секреты и зашифрованная Instagram-сессия ----------
def load_or_create_secret(path: Path, env_name: str) -> str:
value = os.getenv(env_name)
if value:
return value
path.parent.mkdir(parents=True, exist_ok=True)
try:
fd = os.open(str(path), os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600)
with os.fdopen(fd, "wb") as handle:
secret = secrets.token_bytes(32)
handle.write(secret)
handle.flush()
os.fsync(handle.fileno())
except FileExistsError:
pass
except OSError as exc:
raise RuntimeError(f"Не удалось создать локальный секрет {path.name}") from exc
try:
os.chmod(path, 0o600)
except OSError:
pass
return path.read_bytes().hex()
def get_fernet() -> Fernet:
env_key = os.getenv("IG_SESSION_KEY")
if env_key:
key = env_key.strip().encode("ascii")
else:
SESSION_KEY_FILE.parent.mkdir(parents=True, exist_ok=True)
try:
fd = os.open(
str(SESSION_KEY_FILE),
os.O_CREAT | os.O_EXCL | os.O_WRONLY,
0o600,
)
with os.fdopen(fd, "wb") as handle:
handle.write(Fernet.generate_key())
handle.flush()
os.fsync(handle.fileno())
except FileExistsError:
pass
except OSError as exc:
raise RuntimeError("Не удалось создать локальный ключ сессии") from exc
try:
os.chmod(SESSION_KEY_FILE, 0o600)
except OSError:
pass
key = SESSION_KEY_FILE.read_bytes().strip()
try:
return Fernet(key)
except Exception as exc:
raise RuntimeError("IG_SESSION_KEY или локальный ключ сессии некорректен") from exc
def remove_password_fields(value: Any) -> Any:
"""Защитная фильтрация на случай, если библиотека вернёт пароль в settings."""
forbidden = {"password", "passwd", "login_password"}
if isinstance(value, dict):
return {
key: remove_password_fields(item)
for key, item in value.items()
if str(key).casefold() not in forbidden
}
if isinstance(value, list):
return [remove_password_fields(item) for item in value]
return value
def load_saved_settings(username: str) -> dict[str, Any] | None:
if not SESSION_FILE.exists():
return None
try:
payload = get_fernet().decrypt(SESSION_FILE.read_bytes())
document = json.loads(payload.decode("utf-8"))
if str(document.get("username", "")).casefold() != username.casefold():
return None
settings = document.get("settings")
return settings if isinstance(settings, dict) else None
except (InvalidToken, ValueError, OSError, json.JSONDecodeError):
logging.warning("Не удалось расшифровать локальную сессию; войдите заново.")
return None
except Exception as exc:
logging.warning("Не удалось прочитать локальную сессию (%s).", type(exc).__name__)
return None
def save_encrypted_settings(username: str, client: Client) -> None:
settings = remove_password_fields(client.get_settings())
document = {
"username": username,
"settings": settings,
"saved_at": datetime.now(timezone.utc).isoformat(timespec="seconds"),
}
raw = json.dumps(document, ensure_ascii=False, separators=(",", ":")).encode("utf-8")
encrypted = get_fernet().encrypt(raw)
atomic_write(SESSION_FILE, encrypted, mode=0o600)
# ---------- Flask и защита панели ----------
class AdminPrefixMiddleware:
"""Монтирует всё приложение под /admhosto, сохраняя корректный url_for()."""
def __init__(self, application, prefix: str):
self.application = application
self.prefix = prefix.rstrip("/")
def __call__(self, environ, start_response):
path_info = environ.get("PATH_INFO", "") or "/"
if path_info == self.prefix or path_info.startswith(self.prefix + "/"):
suffix = path_info[len(self.prefix):] or "/"
environ["PATH_INFO"] = suffix
script_name = environ.get("SCRIPT_NAME", "")
if not script_name.endswith(self.prefix):
environ["SCRIPT_NAME"] = script_name + self.prefix
return self.application(environ, start_response)
if path_info in {"", "/"}:
body = b""
start_response("302 Found", [("Location", self.prefix + "/"), ("Content-Length", "0"), ("Cache-Control", "no-store")])
return [body]
body = b"Not Found"
start_response("404 Not Found", [("Content-Type", "text/plain; charset=utf-8"), ("Content-Length", str(len(body)))])
return [body]
app = Flask(__name__)
app.wsgi_app = AdminPrefixMiddleware(app.wsgi_app, ADMIN_PATH)
app.secret_key = load_or_create_secret(FLASK_SECRET_FILE, "FLASK_SECRET_KEY")
app.config.update(
SESSION_COOKIE_HTTPONLY=True,
SESSION_COOKIE_SAMESITE="Lax",
SESSION_COOKIE_PATH=ADMIN_PATH,
SESSION_COOKIE_SECURE=PUBLIC_MODE, # в публичном Space cookie передаётся только по HTTPS
PERMANENT_SESSION_LIFETIME=timedelta(hours=8),
MAX_CONTENT_LENGTH=64 * 1024,
)
def csrf_token() -> str:
if "_csrf" not in session:
session["_csrf"] = secrets.token_urlsafe(32)
return str(session["_csrf"])
@app.before_request
def enforce_localhost_and_csrf() -> None:
# В обычном режиме принимаем запросы только с loopback. В PUBLIC_MODE
# Space доступен извне, но все операции остаются за паролем панели и CSRF.
if not PUBLIC_MODE:
remote = request.remote_addr or ""
try:
if not ipaddress.ip_address(remote).is_loopback:
abort(403)
except ValueError:
abort(403)
if request.method in {"POST", "PUT", "PATCH", "DELETE"}:
expected = str(session.get("_csrf", ""))
supplied = request.form.get("csrf_token", "") or request.headers.get("X-CSRF-Token", "")
if not expected or not hmac.compare_digest(expected, supplied):
abort(400, "CSRF token is missing or invalid")
@app.after_request
def set_security_headers(response):
response.headers["X-Content-Type-Options"] = "nosniff"
response.headers["X-Frame-Options"] = "DENY"
response.headers["Referrer-Policy"] = "no-referrer"
response.headers["Cache-Control"] = "no-store"
response.headers["Content-Security-Policy"] = (
"default-src 'self'; style-src 'unsafe-inline'; img-src 'self' data:; "
"script-src 'none'; object-src 'none'; base-uri 'self'; frame-ancestors 'none'; form-action 'self'"
)
return response
def admin_required(function):
@wraps(function)
def wrapped(*args, **kwargs):
if not session.get("admin_authenticated"):
return redirect(url_for("panel_login"))
return function(*args, **kwargs)
return wrapped
LOGIN_PAGE = r"""
Панель Instagram
Локальная Instagram-панель
{% if public_mode %}Вход в защищённую панель Instagram в Hugging Face Space.{% else %}Вход в панель управления, работающую только на этом компьютере.{% endif %}
Не отправляйте ссылку, пароль панели, пароль Instagram или файлы сессии другим людям. Эта панель не подключает ChatGPT к аккаунту.
{% with messages = get_flashed_messages() %}{% for message in messages %}
Запрос выполняется в фоне, страница не должна зависнуть. Первичная авторизация может занять до минуты.
{{ message }}
{% if elapsed >= 120 %}
Вход длится уже {{ elapsed }} секунд. Возможно, Instagram не отвечает или ожидает challenge. Не отправляйте форму повторно; проверьте логи Space и затем обновите статус.
{% with messages = get_flashed_messages(with_categories=true) %}{% for category,message in messages %}
{{ message }}
{% endfor %}{% endwith %}
{% if public_mode %}Это публичный Space: защищайте его паролем панели и не передавайте пароль третьим лицам. Он не подключает ChatGPT к аккаунту.{% else %}Панель доступна только на этом компьютере и не создаёт публичную ссылку.{% endif %} Instagrapi использует неофициальный интерфейс Instagram; возможны проверки безопасности или блокировка входа.
{% if not connected %}
Подключить Instagram
Введите данные только в локальной панели. Пароль используется для входа в памяти процесса и не записывается в data.json. Файл сессии хранится отдельно в зашифрованном виде.
Если Instagram запросит подтверждение устройства или challenge, завершите проверку в официальном приложении/на сайте и повторите вход.
{% else %}
Входящие сообщения
Загрузка последних 20 диалогов. Содержимое диалогов показывается только по отдельному нажатию.
{% if inbox is defined %}{% if inbox %}
{% for item in inbox %}
{{ item.title }}
{{ item.preview }}
{% endfor %}
{% else %}
Диалогов не найдено.
{% endif %}{% endif %}
Поиск пользователей
Поиск публичных профилей по имени пользователя или запросу.
{% if search_results is defined %}{% if search_results %}
{% for user in search_results %}
@{{ user.username }}
{{ user.full_name }}
{% endfor %}
{% else %}
Совпадений не найдено.
{% endif %}{% endif %}
Отправить одно сообщение
Только одному явно указанному пользователю за раз. Перед отправкой проверьте адресата и текст.
Отключить Instagram
Выйти из Instagram-сессии на сервере панели и удалить сохранённую зашифрованную сессию.