tcp_proxy.py 46 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214
  1. """TLS proxy for slicer-to-printer communication.
  2. This module provides a TLS terminating proxy that forwards data between
  3. a slicer and a real Bambu printer, enabling remote printing over
  4. any network connection.
  5. Unlike a transparent TCP proxy, this terminates TLS on both ends:
  6. - Slicer connects to Bambuddy using Bambuddy's certificate
  7. - Bambuddy connects to printer using printer's certificate
  8. - Data is decrypted, forwarded, and re-encrypted
  9. """
  10. import asyncio
  11. import logging
  12. import random
  13. import re
  14. import ssl
  15. import subprocess
  16. from collections.abc import Callable
  17. from pathlib import Path
  18. logger = logging.getLogger(__name__)
  19. def detect_port_redirect(port: int) -> int | None:
  20. """Detect if iptables redirects a port to another port.
  21. When iptables NAT REDIRECT rules exist (e.g. 990→9990), connections
  22. to the original port never reach our socket because iptables intercepts
  23. them in PREROUTING. We must listen on the redirect target instead.
  24. Returns the redirect target port, or None if no redirect is active.
  25. """
  26. # Method 1: Read persistent rules file (doesn't require root)
  27. for rules_path in ("/etc/iptables/rules.v4", "/etc/iptables.rules"):
  28. try:
  29. with open(rules_path) as f:
  30. content = f.read()
  31. match = re.search(rf"--dport {port}\b.*?--to-ports\s+(\d+)", content)
  32. if match:
  33. target = int(match.group(1))
  34. if target != port:
  35. return target
  36. except (FileNotFoundError, PermissionError, OSError):
  37. continue
  38. # Method 2: Query live iptables rules (may require root)
  39. try:
  40. result = subprocess.run( # noqa: S603, S607
  41. ["iptables-save", "-t", "nat"],
  42. capture_output=True,
  43. text=True,
  44. timeout=5,
  45. )
  46. if result.returncode == 0:
  47. match = re.search(rf"--dport {port}\b.*?--to-ports\s+(\d+)", result.stdout)
  48. if match:
  49. target = int(match.group(1))
  50. if target != port:
  51. return target
  52. except (FileNotFoundError, subprocess.TimeoutExpired, OSError):
  53. pass
  54. return None
  55. class TLSProxy:
  56. """TLS terminating proxy that forwards data between client and target.
  57. This proxy terminates TLS on both ends, allowing the slicer to connect
  58. to Bambuddy's certificate while Bambuddy connects to the real printer.
  59. """
  60. def __init__(
  61. self,
  62. name: str,
  63. listen_port: int,
  64. target_host: str,
  65. target_port: int,
  66. server_cert_path: Path,
  67. server_key_path: Path,
  68. on_connect: Callable[[str], None] | None = None,
  69. on_disconnect: Callable[[str], None] | None = None,
  70. ):
  71. """Initialize the TLS proxy.
  72. Args:
  73. name: Friendly name for logging (e.g., "FTP", "MQTT")
  74. listen_port: Port to listen on for incoming connections
  75. target_host: Target printer IP/hostname
  76. target_port: Target printer port
  77. server_cert_path: Path to server certificate (for accepting slicer connections)
  78. server_key_path: Path to server private key
  79. on_connect: Optional callback when client connects (receives client_id)
  80. on_disconnect: Optional callback when client disconnects (receives client_id)
  81. """
  82. self.name = name
  83. self.listen_port = listen_port
  84. self.target_host = target_host
  85. self.target_port = target_port
  86. self.server_cert_path = server_cert_path
  87. self.server_key_path = server_key_path
  88. self.on_connect = on_connect
  89. self.on_disconnect = on_disconnect
  90. self._server: asyncio.Server | None = None
  91. self._running = False
  92. self._active_connections: dict[str, tuple[asyncio.Task, asyncio.Task]] = {}
  93. self._server_ssl_context: ssl.SSLContext | None = None
  94. self._client_ssl_context: ssl.SSLContext | None = None
  95. def _create_server_ssl_context(self) -> ssl.SSLContext:
  96. """Create SSL context for accepting client (slicer) connections."""
  97. ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_SERVER)
  98. ctx.load_cert_chain(self.server_cert_path, self.server_key_path)
  99. # Allow older TLS versions for compatibility with slicers
  100. ctx.minimum_version = ssl.TLSVersion.TLSv1_2
  101. # Don't require client certificates
  102. ctx.verify_mode = ssl.CERT_NONE
  103. return ctx
  104. def _create_client_ssl_context(self) -> ssl.SSLContext:
  105. """Create SSL context for connecting to printer."""
  106. ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
  107. # Don't verify printer's certificate (self-signed)
  108. ctx.check_hostname = False
  109. ctx.verify_mode = ssl.CERT_NONE
  110. ctx.minimum_version = ssl.TLSVersion.TLSv1_2
  111. return ctx
  112. async def start(self) -> None:
  113. """Start the TLS proxy server."""
  114. if self._running:
  115. return
  116. logger.info(
  117. f"Starting {self.name} TLS proxy: 0.0.0.0:{self.listen_port} → {self.target_host}:{self.target_port}"
  118. )
  119. try:
  120. self._running = True
  121. # Create SSL contexts
  122. self._server_ssl_context = self._create_server_ssl_context()
  123. self._client_ssl_context = self._create_client_ssl_context()
  124. # Start server with TLS
  125. self._server = await asyncio.start_server(
  126. self._handle_client,
  127. "0.0.0.0", # nosec B104
  128. self.listen_port,
  129. ssl=self._server_ssl_context,
  130. )
  131. logger.info("%s TLS proxy listening on port %s", self.name, self.listen_port)
  132. async with self._server:
  133. await self._server.serve_forever()
  134. except OSError as e:
  135. if e.errno == 98: # Address already in use
  136. logger.error("%s proxy port %s is already in use", self.name, self.listen_port)
  137. elif e.errno == 13: # Permission denied
  138. logger.error(
  139. "%s proxy: cannot bind to port %s (permission denied). "
  140. "Port %s requires root or CAP_NET_BIND_SERVICE. "
  141. "Docker: add 'cap_add: [NET_BIND_SERVICE]' to docker-compose.yml. "
  142. "Native: use 'sudo setcap cap_net_bind_service=+ep $(which python3)' "
  143. "or redirect with iptables.",
  144. self.name,
  145. self.listen_port,
  146. self.listen_port,
  147. )
  148. else:
  149. logger.error("%s proxy error: %s", self.name, e)
  150. except asyncio.CancelledError:
  151. logger.debug("%s proxy task cancelled", self.name)
  152. except Exception as e:
  153. logger.error("%s proxy error: %s", self.name, e)
  154. finally:
  155. await self.stop()
  156. async def stop(self) -> None:
  157. """Stop the TLS proxy server."""
  158. logger.info("Stopping %s proxy", self.name)
  159. self._running = False
  160. # Cancel all active connection tasks
  161. for client_id, (task1, task2) in list(self._active_connections.items()):
  162. task1.cancel()
  163. task2.cancel()
  164. if self.on_disconnect:
  165. try:
  166. self.on_disconnect(client_id)
  167. except Exception:
  168. pass # Ignore disconnect callback errors during shutdown
  169. self._active_connections.clear()
  170. if self._server:
  171. try:
  172. self._server.close()
  173. await self._server.wait_closed()
  174. except OSError as e:
  175. logger.debug("Error closing %s proxy server: %s", self.name, e)
  176. self._server = None
  177. async def _handle_client(
  178. self,
  179. client_reader: asyncio.StreamReader,
  180. client_writer: asyncio.StreamWriter,
  181. ) -> None:
  182. """Handle a new client connection by proxying to target."""
  183. peername = client_writer.get_extra_info("peername")
  184. client_id = f"{peername[0]}:{peername[1]}" if peername else "unknown"
  185. logger.info("%s proxy: client connected from %s", self.name, client_id)
  186. if self.on_connect:
  187. try:
  188. self.on_connect(client_id)
  189. except Exception:
  190. pass # Ignore connect callback errors; connection proceeds regardless
  191. # Connect to target printer with TLS
  192. try:
  193. printer_reader, printer_writer = await asyncio.wait_for(
  194. asyncio.open_connection(
  195. self.target_host,
  196. self.target_port,
  197. ssl=self._client_ssl_context,
  198. ),
  199. timeout=10.0,
  200. )
  201. logger.info("%s proxy: connected to printer %s:%s", self.name, self.target_host, self.target_port)
  202. except TimeoutError:
  203. logger.error("%s proxy: timeout connecting to %s:%s", self.name, self.target_host, self.target_port)
  204. client_writer.close()
  205. await client_writer.wait_closed()
  206. return
  207. except ssl.SSLError as e:
  208. logger.error(
  209. "%s proxy: SSL error connecting to %s:%s: %s", self.name, self.target_host, self.target_port, e
  210. )
  211. client_writer.close()
  212. await client_writer.wait_closed()
  213. return
  214. except OSError as e:
  215. logger.error("%s proxy: failed to connect to %s:%s: %s", self.name, self.target_host, self.target_port, e)
  216. client_writer.close()
  217. await client_writer.wait_closed()
  218. return
  219. # Create bidirectional forwarding tasks
  220. client_to_printer = asyncio.create_task(
  221. self._forward(client_reader, printer_writer, f"{client_id}→printer"),
  222. name=f"{self.name}_c2p_{client_id}",
  223. )
  224. printer_to_client = asyncio.create_task(
  225. self._forward(printer_reader, client_writer, f"printer→{client_id}"),
  226. name=f"{self.name}_p2c_{client_id}",
  227. )
  228. self._active_connections[client_id] = (client_to_printer, printer_to_client)
  229. try:
  230. # Wait for either direction to complete (connection closed)
  231. done, pending = await asyncio.wait(
  232. [client_to_printer, printer_to_client],
  233. return_when=asyncio.FIRST_COMPLETED,
  234. )
  235. # Cancel the other direction
  236. for task in pending:
  237. task.cancel()
  238. try:
  239. await task
  240. except asyncio.CancelledError:
  241. pass # Expected when cancelling the other forwarding direction
  242. except Exception as e:
  243. logger.debug("%s proxy connection error: %s", self.name, e)
  244. finally:
  245. # Clean up
  246. self._active_connections.pop(client_id, None)
  247. for writer in [client_writer, printer_writer]:
  248. try:
  249. writer.close()
  250. await writer.wait_closed()
  251. except OSError:
  252. pass # Best-effort connection cleanup; peer may have disconnected
  253. logger.info("%s proxy: client %s disconnected", self.name, client_id)
  254. if self.on_disconnect:
  255. try:
  256. self.on_disconnect(client_id)
  257. except Exception:
  258. pass # Ignore disconnect callback errors; cleanup continues
  259. async def _forward(
  260. self,
  261. reader: asyncio.StreamReader,
  262. writer: asyncio.StreamWriter,
  263. direction: str,
  264. ) -> None:
  265. """Forward data from reader to writer.
  266. Args:
  267. reader: Source stream (already TLS-decrypted)
  268. writer: Destination stream (will be TLS-encrypted by the stream)
  269. direction: Description for logging (e.g., "client→printer")
  270. """
  271. total_bytes = 0
  272. try:
  273. while self._running:
  274. # Read chunk - use reasonable buffer size
  275. data = await reader.read(65536)
  276. if not data:
  277. # Connection closed
  278. break
  279. # Forward to destination
  280. writer.write(data)
  281. await writer.drain()
  282. total_bytes += len(data)
  283. logger.debug("%s proxy %s: %s bytes", self.name, direction, len(data))
  284. except asyncio.CancelledError:
  285. pass # Expected when the other forwarding direction closes first
  286. except ConnectionResetError:
  287. logger.debug("%s proxy %s: connection reset", self.name, direction)
  288. except BrokenPipeError:
  289. logger.debug("%s proxy %s: broken pipe", self.name, direction)
  290. except OSError as e:
  291. logger.debug("%s proxy %s error: %s", self.name, direction, e)
  292. logger.debug("%s proxy %s: total %s bytes", self.name, direction, total_bytes)
  293. class TCPProxy:
  294. """Raw TCP proxy that forwards data without TLS termination.
  295. Used for protocols where the printer doesn't use TLS (e.g., port 3000
  296. binding/authentication protocol).
  297. """
  298. def __init__(
  299. self,
  300. name: str,
  301. listen_port: int,
  302. target_host: str,
  303. target_port: int,
  304. on_connect: Callable[[str], None] | None = None,
  305. on_disconnect: Callable[[str], None] | None = None,
  306. ):
  307. self.name = name
  308. self.listen_port = listen_port
  309. self.target_host = target_host
  310. self.target_port = target_port
  311. self.on_connect = on_connect
  312. self.on_disconnect = on_disconnect
  313. self._server: asyncio.Server | None = None
  314. self._running = False
  315. self._active_connections: dict[str, tuple[asyncio.Task, asyncio.Task]] = {}
  316. async def start(self) -> None:
  317. """Start the TCP proxy server."""
  318. if self._running:
  319. return
  320. logger.info(
  321. "Starting %s TCP proxy: 0.0.0.0:%s → %s:%s",
  322. self.name,
  323. self.listen_port,
  324. self.target_host,
  325. self.target_port,
  326. )
  327. try:
  328. self._running = True
  329. self._server = await asyncio.start_server(
  330. self._handle_client,
  331. "0.0.0.0", # nosec B104
  332. self.listen_port,
  333. )
  334. logger.info("%s TCP proxy listening on port %s", self.name, self.listen_port)
  335. async with self._server:
  336. await self._server.serve_forever()
  337. except OSError as e:
  338. if e.errno == 98: # Address already in use
  339. logger.error("%s proxy port %s is already in use", self.name, self.listen_port)
  340. else:
  341. logger.error("%s proxy error: %s", self.name, e)
  342. except asyncio.CancelledError:
  343. logger.debug("%s proxy task cancelled", self.name)
  344. except Exception as e:
  345. logger.error("%s proxy error: %s", self.name, e)
  346. finally:
  347. await self.stop()
  348. async def stop(self) -> None:
  349. """Stop the TCP proxy server."""
  350. logger.info("Stopping %s proxy", self.name)
  351. self._running = False
  352. for client_id, (task1, task2) in list(self._active_connections.items()):
  353. task1.cancel()
  354. task2.cancel()
  355. if self.on_disconnect:
  356. try:
  357. self.on_disconnect(client_id)
  358. except Exception:
  359. pass
  360. self._active_connections.clear()
  361. if self._server:
  362. try:
  363. self._server.close()
  364. await self._server.wait_closed()
  365. except OSError as e:
  366. logger.debug("Error closing %s proxy server: %s", self.name, e)
  367. self._server = None
  368. async def _handle_client(
  369. self,
  370. client_reader: asyncio.StreamReader,
  371. client_writer: asyncio.StreamWriter,
  372. ) -> None:
  373. """Handle a new client connection by proxying to target."""
  374. peername = client_writer.get_extra_info("peername")
  375. client_id = f"{peername[0]}:{peername[1]}" if peername else "unknown"
  376. logger.info("%s proxy: client connected from %s", self.name, client_id)
  377. if self.on_connect:
  378. try:
  379. self.on_connect(client_id)
  380. except Exception:
  381. pass
  382. try:
  383. printer_reader, printer_writer = await asyncio.wait_for(
  384. asyncio.open_connection(self.target_host, self.target_port),
  385. timeout=10.0,
  386. )
  387. logger.info("%s proxy: connected to printer %s:%s", self.name, self.target_host, self.target_port)
  388. except TimeoutError:
  389. logger.error("%s proxy: timeout connecting to %s:%s", self.name, self.target_host, self.target_port)
  390. client_writer.close()
  391. await client_writer.wait_closed()
  392. return
  393. except OSError as e:
  394. logger.error("%s proxy: failed to connect to %s:%s: %s", self.name, self.target_host, self.target_port, e)
  395. client_writer.close()
  396. await client_writer.wait_closed()
  397. return
  398. client_to_printer = asyncio.create_task(
  399. self._forward(client_reader, printer_writer, f"{client_id}→printer"),
  400. name=f"{self.name}_c2p_{client_id}",
  401. )
  402. printer_to_client = asyncio.create_task(
  403. self._forward(printer_reader, client_writer, f"printer→{client_id}"),
  404. name=f"{self.name}_p2c_{client_id}",
  405. )
  406. self._active_connections[client_id] = (client_to_printer, printer_to_client)
  407. try:
  408. done, pending = await asyncio.wait(
  409. [client_to_printer, printer_to_client],
  410. return_when=asyncio.FIRST_COMPLETED,
  411. )
  412. for task in pending:
  413. task.cancel()
  414. try:
  415. await task
  416. except asyncio.CancelledError:
  417. pass
  418. except Exception as e:
  419. logger.debug("%s proxy connection error: %s", self.name, e)
  420. finally:
  421. self._active_connections.pop(client_id, None)
  422. for writer in [client_writer, printer_writer]:
  423. try:
  424. writer.close()
  425. await writer.wait_closed()
  426. except OSError:
  427. pass
  428. logger.info("%s proxy: client %s disconnected", self.name, client_id)
  429. if self.on_disconnect:
  430. try:
  431. self.on_disconnect(client_id)
  432. except Exception:
  433. pass
  434. async def _forward(
  435. self,
  436. reader: asyncio.StreamReader,
  437. writer: asyncio.StreamWriter,
  438. direction: str,
  439. ) -> None:
  440. """Forward data from reader to writer."""
  441. total_bytes = 0
  442. try:
  443. while self._running:
  444. data = await reader.read(65536)
  445. if not data:
  446. break
  447. writer.write(data)
  448. await writer.drain()
  449. total_bytes += len(data)
  450. logger.debug("%s proxy %s: %s bytes", self.name, direction, len(data))
  451. except asyncio.CancelledError:
  452. pass
  453. except ConnectionResetError:
  454. logger.debug("%s proxy %s: connection reset", self.name, direction)
  455. except BrokenPipeError:
  456. logger.debug("%s proxy %s: broken pipe", self.name, direction)
  457. except OSError as e:
  458. logger.debug("%s proxy %s error: %s", self.name, direction, e)
  459. logger.debug("%s proxy %s: total %s bytes", self.name, direction, total_bytes)
  460. class FTPTLSProxy(TLSProxy):
  461. """FTP-aware TLS proxy that handles passive data connections.
  462. Extends TLSProxy to intercept PASV/EPSV responses on the FTP control
  463. channel, dynamically create TLS data proxies on local ports, and rewrite
  464. the responses so the slicer connects to the proxy instead of the printer.
  465. Without this, FTP passive data connections bypass the proxy and go directly
  466. to the printer, which fails when the slicer can't reach the printer's IP.
  467. """
  468. PASV_PORT_MIN = 50000
  469. PASV_PORT_MAX = 50100
  470. async def stop(self) -> None:
  471. """Stop proxy and clean up data connection servers."""
  472. # Close all data servers first
  473. for server in list(self._data_servers):
  474. try:
  475. server.close()
  476. await server.wait_closed()
  477. except OSError:
  478. pass # Best-effort cleanup of data proxy servers
  479. self._data_servers.clear()
  480. await super().stop()
  481. async def start(self) -> None:
  482. """Start the FTP TLS proxy."""
  483. self._data_servers: list[asyncio.Server] = []
  484. await super().start()
  485. async def _handle_client(
  486. self,
  487. client_reader: asyncio.StreamReader,
  488. client_writer: asyncio.StreamWriter,
  489. ) -> None:
  490. """Handle FTP client with PASV/EPSV-aware response forwarding."""
  491. peername = client_writer.get_extra_info("peername")
  492. client_id = f"{peername[0]}:{peername[1]}" if peername else "unknown"
  493. logger.info("%s proxy: client connected from %s", self.name, client_id)
  494. if self.on_connect:
  495. try:
  496. self.on_connect(client_id)
  497. except Exception:
  498. pass # Ignore connect callback errors; connection proceeds regardless
  499. # Determine our local IP from the control connection socket
  500. sockname = client_writer.get_extra_info("sockname")
  501. local_ip = sockname[0] if sockname else "0.0.0.0" # nosec B104
  502. if local_ip in ("0.0.0.0", "::"): # nosec B104
  503. local_ip = "127.0.0.1"
  504. # Connect to target printer with TLS
  505. try:
  506. printer_reader, printer_writer = await asyncio.wait_for(
  507. asyncio.open_connection(
  508. self.target_host,
  509. self.target_port,
  510. ssl=self._client_ssl_context,
  511. ),
  512. timeout=10.0,
  513. )
  514. logger.info("%s proxy: connected to printer %s:%s", self.name, self.target_host, self.target_port)
  515. except TimeoutError:
  516. logger.error("%s proxy: timeout connecting to %s:%s", self.name, self.target_host, self.target_port)
  517. client_writer.close()
  518. await client_writer.wait_closed()
  519. return
  520. except ssl.SSLError as e:
  521. logger.error(
  522. "%s proxy: SSL error connecting to %s:%s: %s", self.name, self.target_host, self.target_port, e
  523. )
  524. client_writer.close()
  525. await client_writer.wait_closed()
  526. return
  527. except OSError as e:
  528. logger.error("%s proxy: failed to connect to %s:%s: %s", self.name, self.target_host, self.target_port, e)
  529. client_writer.close()
  530. await client_writer.wait_closed()
  531. return
  532. # Track data channel protection level per session.
  533. # PROT C = cleartext data, PROT P = TLS data.
  534. # Default to cleartext — many Bambu printers (A1, H2D) use PROT C.
  535. # If the slicer sends PROT P, we switch to TLS for data connections.
  536. session_state: dict[str, str] = {"prot": "C"}
  537. # Client→Printer: intercept EPSV and replace with PASV
  538. # EPSV responses only contain a port (no IP), so the slicer reuses
  539. # the control connection IP. If that IP is the real printer (via
  540. # iptables REDIRECT), the data connection bypasses the proxy.
  541. # PASV responses include an explicit IP that we can rewrite.
  542. client_to_printer = asyncio.create_task(
  543. self._forward_ftp_commands(client_reader, printer_writer, f"{client_id}→printer", session_state),
  544. name=f"{self.name}_c2p_{client_id}",
  545. )
  546. # Printer→Client: intercept PASV/EPSV responses
  547. printer_to_client = asyncio.create_task(
  548. self._forward_ftp_control(printer_reader, client_writer, f"printer→{client_id}", local_ip, session_state),
  549. name=f"{self.name}_p2c_{client_id}",
  550. )
  551. self._active_connections[client_id] = (client_to_printer, printer_to_client)
  552. try:
  553. done, pending = await asyncio.wait(
  554. [client_to_printer, printer_to_client],
  555. return_when=asyncio.FIRST_COMPLETED,
  556. )
  557. for task in pending:
  558. task.cancel()
  559. try:
  560. await task
  561. except asyncio.CancelledError:
  562. pass # Expected when cancelling the other forwarding direction
  563. except Exception as e:
  564. logger.debug("%s proxy connection error: %s", self.name, e)
  565. finally:
  566. self._active_connections.pop(client_id, None)
  567. for writer in [client_writer, printer_writer]:
  568. try:
  569. writer.close()
  570. await writer.wait_closed()
  571. except OSError:
  572. pass # Best-effort connection cleanup; peer may have disconnected
  573. logger.info("%s proxy: client %s disconnected", self.name, client_id)
  574. if self.on_disconnect:
  575. try:
  576. self.on_disconnect(client_id)
  577. except Exception:
  578. pass # Ignore disconnect callback errors; cleanup continues
  579. async def _forward_ftp_commands(
  580. self,
  581. reader: asyncio.StreamReader,
  582. writer: asyncio.StreamWriter,
  583. direction: str,
  584. session_state: dict[str, str],
  585. ) -> None:
  586. """Forward FTP client commands, replacing EPSV with PASV.
  587. EPSV responses only contain a port number — the client reuses the
  588. control connection IP for data. When the control IP is the real
  589. printer (due to iptables REDIRECT), EPSV data connections bypass
  590. the proxy. PASV responses include an explicit IP that the proxy
  591. can rewrite to its own address.
  592. Also tracks PROT P/C commands to know whether data connections
  593. should use TLS or cleartext.
  594. """
  595. buffer = b""
  596. total_bytes = 0
  597. try:
  598. while self._running:
  599. data = await reader.read(65536)
  600. if not data:
  601. break
  602. total_bytes += len(data)
  603. buffer += data
  604. output = b""
  605. while b"\r\n" in buffer:
  606. idx = buffer.index(b"\r\n")
  607. line = buffer[:idx]
  608. buffer = buffer[idx + 2 :]
  609. cmd_upper = line.strip().upper()
  610. # Replace EPSV with PASV so response includes an IP
  611. if cmd_upper == b"EPSV":
  612. line = b"PASV"
  613. logger.info("FTP command rewrite: EPSV → PASV")
  614. # Track PROT level for data channel encryption
  615. elif cmd_upper == b"PROT P":
  616. session_state["prot"] = "P"
  617. logger.info("FTP data protection: PROT P (TLS)")
  618. elif cmd_upper == b"PROT C":
  619. session_state["prot"] = "C"
  620. logger.info("FTP data protection: PROT C (cleartext)")
  621. output += line + b"\r\n"
  622. if output:
  623. writer.write(output)
  624. await writer.drain()
  625. logger.debug("%s proxy %s: %s bytes", self.name, direction, len(data))
  626. except asyncio.CancelledError:
  627. pass # Expected when the other forwarding direction closes first
  628. except ConnectionResetError:
  629. logger.debug("%s proxy %s: connection reset", self.name, direction)
  630. except BrokenPipeError:
  631. logger.debug("%s proxy %s: broken pipe", self.name, direction)
  632. except OSError as e:
  633. logger.debug("%s proxy %s error: %s", self.name, direction, e)
  634. if buffer:
  635. try:
  636. writer.write(buffer)
  637. await writer.drain()
  638. except OSError:
  639. pass # Best-effort flush of remaining FTP command data
  640. logger.debug("%s proxy %s: total %s bytes", self.name, direction, total_bytes)
  641. async def _forward_ftp_control(
  642. self,
  643. reader: asyncio.StreamReader,
  644. writer: asyncio.StreamWriter,
  645. direction: str,
  646. local_ip: str,
  647. session_state: dict[str, str],
  648. ) -> None:
  649. """Forward FTP control channel responses, rewriting PASV/EPSV.
  650. FTP control channel is line-based (\\r\\n terminated). We buffer data
  651. and process complete lines, intercepting 227 (PASV) and 229 (EPSV)
  652. responses to create local data proxies.
  653. """
  654. buffer = b""
  655. total_bytes = 0
  656. try:
  657. while self._running:
  658. data = await reader.read(65536)
  659. if not data:
  660. break
  661. total_bytes += len(data)
  662. buffer += data
  663. output = b""
  664. # Process all complete lines
  665. while b"\r\n" in buffer:
  666. idx = buffer.index(b"\r\n")
  667. line = buffer[:idx]
  668. buffer = buffer[idx + 2 :]
  669. rewritten = await self._maybe_rewrite_pasv(line, local_ip, session_state)
  670. output += rewritten + b"\r\n"
  671. if output:
  672. writer.write(output)
  673. await writer.drain()
  674. logger.debug("%s proxy %s: %s bytes", self.name, direction, len(data))
  675. except asyncio.CancelledError:
  676. pass # Expected when the other forwarding direction closes first
  677. except ConnectionResetError:
  678. logger.debug("%s proxy %s: connection reset", self.name, direction)
  679. except BrokenPipeError:
  680. logger.debug("%s proxy %s: broken pipe", self.name, direction)
  681. except OSError as e:
  682. logger.debug("%s proxy %s error: %s", self.name, direction, e)
  683. # Flush any remaining buffered data
  684. if buffer:
  685. try:
  686. writer.write(buffer)
  687. await writer.drain()
  688. except OSError:
  689. pass # Best-effort flush of remaining FTP control data
  690. logger.debug("%s proxy %s: total %s bytes", self.name, direction, total_bytes)
  691. async def _maybe_rewrite_pasv(self, line: bytes, local_ip: str, session_state: dict[str, str]) -> bytes:
  692. """Rewrite PASV/EPSV response to point to a local data proxy."""
  693. try:
  694. text = line.decode("utf-8")
  695. except UnicodeDecodeError:
  696. return line
  697. # 227 Entering Passive Mode (h1,h2,h3,h4,p1,p2)
  698. if text.startswith("227 "):
  699. match = re.search(r"\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)", text)
  700. if match:
  701. h1, h2, h3, h4, p1, p2 = (int(x) for x in match.groups())
  702. printer_ip = f"{h1}.{h2}.{h3}.{h4}"
  703. printer_port = p1 * 256 + p2
  704. local_port = await self._create_data_proxy(printer_ip, printer_port, session_state)
  705. if local_port:
  706. ip_parts = local_ip.split(".")
  707. lp1 = local_port // 256
  708. lp2 = local_port % 256
  709. rewritten = (
  710. f"227 Entering Passive Mode "
  711. f"({ip_parts[0]},{ip_parts[1]},{ip_parts[2]},{ip_parts[3]},{lp1},{lp2})"
  712. )
  713. logger.info("FTP PASV rewrite: %s:%s → %s:%s", printer_ip, printer_port, local_ip, local_port)
  714. return rewritten.encode("utf-8")
  715. else:
  716. logger.error("FTP PASV: failed to create data proxy for %s:%s", printer_ip, printer_port)
  717. else:
  718. logger.warning("FTP PASV: 227 response didn't match expected format: %s", text[:100])
  719. # 229 Entering Extended Passive Mode (|||port|)
  720. elif text.startswith("229 "):
  721. match = re.search(r"\(\|\|\|(\d+)\|\)", text)
  722. if match:
  723. printer_port = int(match.group(1))
  724. local_port = await self._create_data_proxy(self.target_host, printer_port, session_state)
  725. if local_port:
  726. rewritten = f"229 Entering Extended Passive Mode (|||{local_port}|)"
  727. logger.info("FTP EPSV rewrite: port %s → %s", printer_port, local_port)
  728. return rewritten.encode("utf-8")
  729. else:
  730. logger.error("FTP EPSV: failed to create data proxy for port %s", printer_port)
  731. else:
  732. logger.warning("FTP EPSV: 229 response didn't match expected format: %s", text[:100])
  733. return line
  734. async def _create_data_proxy(self, printer_ip: str, printer_port: int, session_state: dict[str, str]) -> int | None:
  735. """Create a one-shot proxy for an FTP data connection.
  736. Prefers the printer's original passive port so the port number stays
  737. the same in the rewritten PASV/EPSV response. This is critical when
  738. the slicer's FTP bounce-attack protection overrides the IP in the PASV
  739. response: the slicer connects to <control_IP>:<port>, and if iptables
  740. REDIRECT maps that port to the local machine, the data proxy must be
  741. listening on the *same* port number.
  742. Falls back to a random port if the original is unavailable.
  743. Uses TLS or cleartext based on the session's PROT level:
  744. - PROT P: TLS on both slicer and printer data connections
  745. - PROT C: cleartext on both sides (common for A1/H2D printers)
  746. Returns the local port number, or None if binding failed.
  747. """
  748. use_tls = session_state.get("prot") == "P"
  749. logger.info(
  750. "FTP data proxy: creating data proxy for %s:%s (printer-side %s)",
  751. printer_ip,
  752. printer_port,
  753. "TLS" if use_tls else "cleartext",
  754. )
  755. # Try the printer's original port first — this ensures the port
  756. # matches even when bounce protection or iptables REDIRECT is in play.
  757. try:
  758. await self._start_data_proxy_server(printer_port, printer_ip, printer_port, use_tls)
  759. logger.info("FTP data proxy: using printer's port %s", printer_port)
  760. return printer_port
  761. except OSError as e:
  762. logger.debug(
  763. "FTP data proxy: printer port %s unavailable (%s), trying random",
  764. printer_port,
  765. e,
  766. )
  767. for _attempt in range(10):
  768. port = random.randint(self.PASV_PORT_MIN, self.PASV_PORT_MAX)
  769. try:
  770. await self._start_data_proxy_server(port, printer_ip, printer_port, use_tls)
  771. logger.info("FTP data proxy: using random port %s", port)
  772. return port
  773. except OSError:
  774. continue
  775. logger.error("Failed to bind FTP data proxy port after 10 attempts")
  776. return None
  777. async def _start_data_proxy_server(self, port: int, printer_ip: str, printer_port: int, use_tls: bool) -> None:
  778. """Start a one-shot server for one FTP data connection.
  779. The slicer-side listener is ALWAYS cleartext. Even when the slicer
  780. sends PROT P on the control channel, Bambu Studio does not perform
  781. a TLS handshake on the data connection — it relies on the implicit
  782. FTPS control channel for authentication and sends data unencrypted.
  783. The printer-side outbound connection follows the PROT level:
  784. - PROT P (use_tls=True): TLS to the printer's data port
  785. - PROT C (use_tls=False): cleartext to the printer's data port
  786. This mirrors the control channel's TLS-termination architecture.
  787. Raises OSError if the port is already in use.
  788. """
  789. connected = asyncio.Event()
  790. server_holder: list[asyncio.Server] = []
  791. # Slicer side: ALWAYS cleartext — Bambu Studio does not do TLS on
  792. # the data channel even after sending PROT P.
  793. # Printer side: TLS if PROT P, cleartext if PROT C.
  794. client_ssl = self._client_ssl_context if use_tls else None
  795. printer_mode = "TLS" if use_tls else "cleartext"
  796. async def handle_data(
  797. client_reader: asyncio.StreamReader,
  798. client_writer: asyncio.StreamWriter,
  799. ) -> None:
  800. """Handle one FTP data connection, then close the server."""
  801. peername = client_writer.get_extra_info("peername")
  802. data_client = f"{peername[0]}:{peername[1]}" if peername else "unknown"
  803. logger.info(
  804. "FTP data proxy port %s (slicer=cleartext, printer=%s): client connected from %s, bridging to %s:%s",
  805. port,
  806. printer_mode,
  807. data_client,
  808. printer_ip,
  809. printer_port,
  810. )
  811. connected.set()
  812. # One-shot: close server after accepting first connection
  813. if server_holder:
  814. server_holder[0].close()
  815. printer_writer = None
  816. try:
  817. # Connect to printer's data port
  818. printer_reader, printer_writer = await asyncio.wait_for(
  819. asyncio.open_connection(
  820. printer_ip,
  821. printer_port,
  822. ssl=client_ssl,
  823. ),
  824. timeout=10.0,
  825. )
  826. logger.info(
  827. "FTP data proxy port %s (printer=%s): connected to printer %s:%s",
  828. port,
  829. printer_mode,
  830. printer_ip,
  831. printer_port,
  832. )
  833. # Bidirectional data forwarding
  834. c2p = asyncio.create_task(self._forward(client_reader, printer_writer, "data_c2p"))
  835. p2c = asyncio.create_task(self._forward(printer_reader, client_writer, "data_p2c"))
  836. done, pending = await asyncio.wait([c2p, p2c], return_when=asyncio.FIRST_COMPLETED)
  837. for task in pending:
  838. task.cancel()
  839. try:
  840. await task
  841. except asyncio.CancelledError:
  842. pass # Expected when other data direction closes
  843. except TimeoutError:
  844. logger.error("FTP data proxy port %s: timeout connecting to printer", port)
  845. except ssl.SSLError as e:
  846. logger.error("FTP data proxy port %s: SSL error to printer: %s", port, e)
  847. except Exception as e:
  848. logger.error("FTP data proxy port %s: error: %s", port, e)
  849. finally:
  850. for w in [client_writer, printer_writer]:
  851. if w:
  852. try:
  853. w.close()
  854. await w.wait_closed()
  855. except OSError:
  856. pass # Best-effort data connection cleanup
  857. logger.info("FTP data proxy port %s: connection closed", port)
  858. server = await asyncio.start_server(
  859. handle_data,
  860. "0.0.0.0", # nosec B104
  861. port,
  862. # No TLS on slicer side — Bambu Studio doesn't do TLS on data
  863. # channel even after PROT P. The proxy terminates TLS only on
  864. # the printer side (inside handle_data).
  865. )
  866. server_holder.append(server)
  867. self._data_servers.append(server)
  868. # Auto-close after 60s if no connection arrives
  869. async def auto_close() -> None:
  870. try:
  871. await asyncio.wait_for(connected.wait(), timeout=60.0)
  872. except TimeoutError:
  873. logger.debug("FTP data proxy on port %s timed out, closing", port)
  874. try:
  875. server.close()
  876. await server.wait_closed()
  877. except OSError:
  878. pass # Best-effort timeout cleanup
  879. finally:
  880. if server in self._data_servers:
  881. self._data_servers.remove(server)
  882. asyncio.create_task(auto_close(), name=f"ftp_data_timeout_{port}")
  883. logger.debug("FTP data proxy: port %s → %s:%s", port, printer_ip, printer_port)
  884. class SlicerProxyManager:
  885. """Manages FTP and MQTT TLS proxies for a single printer target."""
  886. # Bambu printer ports
  887. PRINTER_FTP_PORT = 990
  888. PRINTER_MQTT_PORT = 8883
  889. PRINTER_BIND_PORT = 3000
  890. # Local listen ports - must match what Bambu Studio expects
  891. # Note: Port 990 requires root or CAP_NET_BIND_SERVICE capability
  892. LOCAL_FTP_PORT = 990
  893. LOCAL_MQTT_PORT = 8883
  894. LOCAL_BIND_PORT = 3000
  895. def __init__(
  896. self,
  897. target_host: str,
  898. cert_path: Path,
  899. key_path: Path,
  900. on_activity: Callable[[str, str], None] | None = None,
  901. ):
  902. """Initialize the slicer proxy manager.
  903. Args:
  904. target_host: Target printer IP address
  905. cert_path: Path to server certificate
  906. key_path: Path to server private key
  907. on_activity: Optional callback for activity logging (name, message)
  908. """
  909. self.target_host = target_host
  910. self.cert_path = cert_path
  911. self.key_path = key_path
  912. self.on_activity = on_activity
  913. self._ftp_proxy: TLSProxy | None = None
  914. self._mqtt_proxy: TLSProxy | None = None
  915. self._bind_proxy: TCPProxy | None = None
  916. self._tasks: list[asyncio.Task] = []
  917. async def start(self) -> None:
  918. """Start FTP and MQTT TLS proxies."""
  919. logger.info("Starting slicer TLS proxy to %s", self.target_host)
  920. # Detect iptables port redirect (e.g. 990→9990 for non-root installs).
  921. # If active, connections to port 990 get intercepted by iptables PREROUTING
  922. # and sent to the redirect target — our socket on 990 never sees them.
  923. ftp_listen_port = self.LOCAL_FTP_PORT
  924. redirect_target = detect_port_redirect(self.LOCAL_FTP_PORT)
  925. if redirect_target:
  926. logger.info(
  927. "Detected iptables redirect: port %d → %d. FTP proxy will listen on %d.",
  928. self.LOCAL_FTP_PORT,
  929. redirect_target,
  930. redirect_target,
  931. )
  932. ftp_listen_port = redirect_target
  933. # Create FTP proxy with PASV/EPSV awareness for data connections
  934. self._ftp_proxy = FTPTLSProxy(
  935. name="FTP",
  936. listen_port=ftp_listen_port,
  937. target_host=self.target_host,
  938. target_port=self.PRINTER_FTP_PORT,
  939. server_cert_path=self.cert_path,
  940. server_key_path=self.key_path,
  941. on_connect=lambda cid: self._log_activity("FTP", f"connected: {cid}"),
  942. on_disconnect=lambda cid: self._log_activity("FTP", f"disconnected: {cid}"),
  943. )
  944. self._mqtt_proxy = TLSProxy(
  945. name="MQTT",
  946. listen_port=self.LOCAL_MQTT_PORT,
  947. target_host=self.target_host,
  948. target_port=self.PRINTER_MQTT_PORT,
  949. server_cert_path=self.cert_path,
  950. server_key_path=self.key_path,
  951. on_connect=lambda cid: self._log_activity("MQTT", f"connected: {cid}"),
  952. on_disconnect=lambda cid: self._log_activity("MQTT", f"disconnected: {cid}"),
  953. )
  954. # Bind/auth proxy (port 3000) - raw TCP, no TLS
  955. self._bind_proxy = TCPProxy(
  956. name="Bind",
  957. listen_port=self.LOCAL_BIND_PORT,
  958. target_host=self.target_host,
  959. target_port=self.PRINTER_BIND_PORT,
  960. on_connect=lambda cid: self._log_activity("Bind", f"connected: {cid}"),
  961. on_disconnect=lambda cid: self._log_activity("Bind", f"disconnected: {cid}"),
  962. )
  963. # Start as background tasks
  964. async def run_with_logging(proxy: TLSProxy) -> None:
  965. try:
  966. await proxy.start()
  967. except Exception as e:
  968. logger.error("Slicer proxy %s failed: %s", proxy.name, e)
  969. self._tasks = [
  970. asyncio.create_task(
  971. run_with_logging(self._ftp_proxy),
  972. name="slicer_proxy_ftp",
  973. ),
  974. asyncio.create_task(
  975. run_with_logging(self._mqtt_proxy),
  976. name="slicer_proxy_mqtt",
  977. ),
  978. asyncio.create_task(
  979. run_with_logging(self._bind_proxy),
  980. name="slicer_proxy_bind",
  981. ),
  982. ]
  983. logger.info("Slicer TLS proxy started for %s", self.target_host)
  984. # Wait for tasks to complete (they run until cancelled)
  985. # This keeps the start() coroutine alive so the parent task doesn't complete
  986. try:
  987. await asyncio.gather(*self._tasks)
  988. except asyncio.CancelledError:
  989. logger.debug("Slicer proxy start cancelled")
  990. async def stop(self) -> None:
  991. """Stop all proxies."""
  992. logger.info("Stopping slicer proxy")
  993. # Stop proxies
  994. if self._ftp_proxy:
  995. await self._ftp_proxy.stop()
  996. self._ftp_proxy = None
  997. if self._mqtt_proxy:
  998. await self._mqtt_proxy.stop()
  999. self._mqtt_proxy = None
  1000. if self._bind_proxy:
  1001. await self._bind_proxy.stop()
  1002. self._bind_proxy = None
  1003. # Cancel tasks
  1004. for task in self._tasks:
  1005. task.cancel()
  1006. if self._tasks:
  1007. try:
  1008. await asyncio.wait_for(
  1009. asyncio.gather(*self._tasks, return_exceptions=True),
  1010. timeout=2.0,
  1011. )
  1012. except TimeoutError:
  1013. logger.debug("Some proxy tasks didn't stop in time")
  1014. self._tasks = []
  1015. logger.info("Slicer proxy stopped")
  1016. def _log_activity(self, name: str, message: str) -> None:
  1017. """Log activity via callback if configured."""
  1018. if self.on_activity:
  1019. try:
  1020. self.on_activity(name, message)
  1021. except Exception:
  1022. pass # Ignore activity callback errors; logging is non-critical
  1023. @property
  1024. def is_running(self) -> bool:
  1025. """Check if proxies are running."""
  1026. return len(self._tasks) > 0 and all(not t.done() for t in self._tasks)
  1027. def get_status(self) -> dict:
  1028. """Get proxy status."""
  1029. return {
  1030. "running": self.is_running,
  1031. "target_host": self.target_host,
  1032. "ftp_port": self.LOCAL_FTP_PORT,
  1033. "mqtt_port": self.LOCAL_MQTT_PORT,
  1034. "bind_port": self.LOCAL_BIND_PORT,
  1035. "ftp_connections": (len(self._ftp_proxy._active_connections) if self._ftp_proxy else 0),
  1036. "mqtt_connections": (len(self._mqtt_proxy._active_connections) if self._mqtt_proxy else 0),
  1037. "bind_connections": (len(self._bind_proxy._active_connections) if self._bind_proxy else 0),
  1038. }