Berth వినియోగ మార్గదర్శిని

SFTP · టెర్మినల్ · సీరియల్ కన్సోల్‌ను ఒకే విండోలో — సర్వర్ జోడించడం నుండి షార్ట్‌కట్‌ల వరకు

🚀ప్రారంభించడం

స్క్రీన్ నిర్మాణం

ఒక్క విండోలో నాలుగు ప్రాంతాలు ఉంటాయి.

మొదటి సర్వర్ జోడించడం

  1. సైడ్‌బార్‌లోని ఖాళీ స్థలంపై కుడి-క్లిక్ చేయండి లేదా ⌘Nను నొక్కండి.
  2. పేరు మరియు సర్వర్ చిరునామాను రాయండి. వినియోగదారు·పోర్ట్‌ను ఖాళీగా వదిలితే డిఫాల్ట్ విలువను వాడుతుంది.
  3. జాబితాలో రెండుసార్లు క్లిక్ చేస్తే కనెక్ట్ అవుతుంది. ఒకసారి క్లిక్ చేయడం ఎంపిక చేయడం.
💡 ఇప్పటికే టెర్మినల్‌లో ssh aliasతో కనెక్ట్ అవుతున్న సర్వర్ అయితే కొత్తగా రాయాల్సింది ఏమీ లేదు. సైడ్‌బార్ మెనూలోని ~/.ssh/config నుండి దిగుమతి చేయి(⌘⇧I)తో ఒకేసారి తీసుకువస్తారు. FileZilla సైట్ జాబితాను కూడా దిగుమతి చేసుకోవచ్చు.

భాష మార్చడం

మెనూలోని Berth › సెట్టింగ్‌లు(⌘,)లో 20 భాషల్లో ఒకదాన్ని ఎంచుకుంటారు. సిస్టమ్ భాషను అనుసరించడం డిఫాల్ట్, ఎంచుకున్న భాష ఈ యాప్‌కు మాత్రమే వర్తిస్తుంది. మార్చిన తర్వాత యాప్‌ను మళ్లీ ప్రారంభిస్తే ప్రతిఫలిస్తుంది.

🗂సర్వర్ మరియు ఫోల్డర్

ఫోల్డర్‌లుగా చేర్చి సెట్టింగ్‌లను వారసత్వంగా ఇవ్వడం

ఫోల్డర్(⌘⇧N)తో సర్వర్‌లను కలిపితే సెట్టింగ్‌లు కిందికి వారసత్వంగా వెళ్తాయి. ఫోల్డర్‌కు వినియోగదారు పేరు లేదా హెచ్చరిక గ్రేడ్‌ను ఒకసారి పెడితే, దాని కింద ఉన్న సర్వర్‌లన్నీ అనుసరిస్తాయి. ఇరవై సర్వర్‌లకు ఒకే విలువను ఇరవై సార్లు రాయకుండా ఉండేందుకు ఉన్న సదుపాయమిది.

సెట్టింగ్‌ల విండోలోని ప్రతి ఫీల్డ్ ఆ విలువ ఎక్కడి నుండి వచ్చిందో(నేను నిర్ణయించానో, ఏ ఫోల్డర్ నుండి వారసత్వంగా వచ్చిందో) కిందన చూపిస్తుంది, తిరిగి తీసుకో బటన్‌తో వారసత్వానికి తిరిగి వెళ్ళవచ్చు.

హెచ్చరిక గ్రేడ్ — డెవలప్‌మెంట్ · స్టేజింగ్ · ప్రొడక్షన్

టైర్ రంగు కంటే పైన ఉంటుంది. ప్రొడక్షన్‌గా ఉంచితే ప్రమాదకర చర్యల ముందు అదనపు నిర్ధారణ అడుగుతుంది. సెషన్ జాబితాలో ఇది మీరు ఎంచుకున్న రంగుతో నింపబడి, ఎరుపు అంచుతో గుర్తించబడుతుంది, కాబట్టి పలు ప్రొడక్షన్ సర్వర్‌లను రంగుతో వేరు చేయవచ్చు. ఒకేసారి ఒకటి మాత్రమే కనిపించే చోట (నిర్ధారణ డైలాగ్‌లు వంటివి) అది గట్టి హెచ్చరికగా ఎరుపుగానే ఉంటుంది.

క్లిక్ నియమాలు

🔑కనెక్షన్ మరియు ప్రామాణీకరణ

మొదటిసారి కనెక్ట్ అయ్యేటప్పుడు — ఫోల్డర్ అనుమతి

Berth App Store నియమాలను (శాండ్‌బాక్స్) పాటిస్తుంది కాబట్టి హోమ్ ఫోల్డర్‌ను ఇష్టం వచ్చినట్టు చదవదు. మొదటి సర్వర్‌ను తెరిచేటప్పుడు SSH సెట్టింగ్‌లు·కీ·known_hosts ఉన్న ఫోల్డర్ను (సాధారణంగా ~/.ssh) ఒకసారి ఎంచుకోమని అడుగుతుంది. ఒకసారి ఎంచుకుంటే గుర్తుంచుకుని మళ్లీ అడగదు. కీని వేరే చోట ఉంచి ఉంటే హోమ్ ఫోల్డర్‌ను ఎంచుకున్నా సరిపోతుంది.

లోకల్ ఫైల్ ప్యానెల్ కూడా అదే కారణంతో మీరు ఎంచుకున్న ఫోల్డర్‌ను రూట్‌గా వాడుతుంది — ప్యానెల్ హెడర్‌లోని లోకల్ ఫోల్డర్ తెరువుతో మార్చవచ్చు, దీన్ని కూడా గుర్తుంచుకుంటుంది.

~/.ssh/configను చదువుతుంది

అలియాస్‌తో కనెక్ట్ అయితే ఆ ఎంట్రీలోని హోస్ట్·పోర్ట్·వినియోగదారు·కీ ఫైల్·ProxyJump· StrictHostKeyCheckingను చదివి వాడుతుంది. సేవ్ చేసిన పోర్ట్ పాతది అయినా సెట్టింగ్‌ల ఫైలే గెలుస్తుంది.

⚠️ రెండు పనులు కావు. ProxyCommand బాహ్య ప్రోగ్రామ్‌ను ప్రారంభించే ఫీచర్ కాబట్టి శాండ్‌బాక్స్‌లో నిరోధించబడుతుంది — జంప్ హోస్ట్‌ను ProxyJumpతో రాయండి. ssh-agentకూ చేరుకోలేము కాబట్టి కీ ఫైల్‌ను నేరుగా చదివి, పాస్‌వర్డ్ ఉన్న కీ అయితే కనెక్ట్ అయ్యేటప్పుడు పాస్‌వర్డ్‌ను అడుగుతుంది.

ప్రామాణీకరణ పద్ధతి

⚠️ టెర్మినల్‌లో కేవలం sshతో కనెక్ట్ అవుతున్న సర్వర్ అయితే ఆటో సరైనది. సహాయం అవుతుందని కీని పేర్కొంటే మాత్రం కనెక్షన్ ఆగిపోతుంది — పేర్కొన్న కీ ఒక్కదాన్నే ప్రయత్నిస్తుంది కాబట్టి.

సర్వర్ అడిగినప్పుడు

పాస్‌వర్డ్‌ను సేవ్ చేసి ఉంచితే కనెక్ట్ అయ్యేటప్పుడు ఒకసారి బదులుగా సమాధానం ఇస్తుంది. మిగతా ప్రశ్నలు — 2-దశల ప్రామాణీకరణ కోడ్, తప్పు పాస్‌వర్డ్‌ను మళ్లీ టైప్ చేయడం, పాస్‌వర్డ్ ఉన్న కీ యొక్క పాస్‌వర్డ్ — "సర్వర్ నుండి అభ్యర్థన వచ్చింది" విండోలో సర్వర్ పంపిన ప్రశ్న యథాతథంగా వచ్చి మీరే నేరుగా సమాధానం ఇవ్వాలి. ఖాతా లాక్ కాకుండా సేవ్ చేసిన పాస్‌వర్డ్‌ను ఒకసారి మాత్రమే ఆటోమేటిక్‌గా ఎంటర్ చేసి, గరిష్టంగా మూడుసార్లే అడుగుతుంది.

పాస్‌వర్డ్ మళ్లీమళ్లీ టైప్ చేయకుండా ఉండాలంటే

సర్వర్‌పై కుడి-క్లిక్ చేసి ఈ సర్వర్‌లో పబ్లిక్ కీ నమోదు…ను ఎంచుకుంటే ~/.sshలోని పబ్లిక్ కీని సర్వర్‌కు అప్‌లోడ్ చేస్తుంది. తర్వాతి నుండి కీతో కనెక్ట్ అవుతుంది.

సేవ్ చేసిన పాస్‌వర్డ్ macOS కీచైన్లో మాత్రమే ఉంటుంది. సెట్టింగ్‌ల ఫైల్‌లో "సేవ్ చేయబడింది" అనే గుర్తు మాత్రమే మిగులుతుంది, విలువ ఉండదు.

తెలియని సర్వర్, మారిన హోస్ట్ కీ

మొదటిసారి కనెక్ట్ అయ్యే సర్వర్ కీ రకం మరియు ఫింగర్‌ప్రింట్ను చూపించి గుర్తుంచుకోవాలా అని అడుగుతుంది. గుర్తుంచుకుంటే ~/.ssh/known_hostsలో ssh లాంటి రూపంలోనే రాసి తర్వాతి నుండి అడగదు.

సర్వర్ గుర్తింపు గత సారి కంటే వేరుగా ఉన్నప్పుడు కూడా కనిపిస్తుంది. ఇది మధ్యవర్తి దాడి కావచ్చు, సర్వర్‌ను మళ్లీ ఇన్‌స్టాల్ చేసినది కూడా కావచ్చు. Berth బదులుగా నిర్ణయించకుండా ఆధారాలు ఇస్తుంది — పాత/కొత్త కీ రకం మరియు ఫింగర్‌ప్రింట్, అలాగే పరికర కన్సోల్‌లో నేరుగా సరిపోల్చి చూసే కమాండ్ వరకు. నిర్ధారించుకున్న తర్వాత "పాత కీని తొలగించి కొత్త కీని గుర్తుంచుకో"ను నొక్కితే పాత ఎంట్రీని తొలగించి (known_hosts.oldలో బ్యాకప్) కొత్త కీని రాస్తుంది.

💡 తరచుగా మళ్లీ ఫ్లాష్ చేసే డెవలప్‌మెంట్ బోర్డు లాగా ప్రతిసారి ఈ విండోను చూసే పరికరాలకు, ఆ సర్వర్ సెట్టింగ్‌లలో హోస్ట్ కీని గుర్తుంచుకోకును ఆన్ చేయవచ్చు. ప్రమాదం ఆ ఒక్క పరికరానికే పరిమితమయ్యేలా known_hostsను తాకదు. ప్రొడక్షన్ గ్రేడ్‌లో ఇది ఆన్ చేయబడదు.

ఫైల్ ప్యానెల్ (SFTP)

అప్‌లోడ్ మరియు డౌన్‌లోడ్

ఎడమవైపు నా Mac, కుడివైపు సర్వర్. లాగి వదలడం ద్వారా లేదా ⌥⌘→(అప్‌లోడ్) · ⌥⌘←(డౌన్‌లోడ్)తో పంపుతారు. పురోగతి బదిలీ లైన్‌లో పేరుకుంటుంది.

టెర్మినల్‌ను అనుసరించే ఫైల్ ప్యానెల్

టెర్మినల్‌లో cd చేస్తే రిమోట్ ప్యానెల్ అదే ఫోల్డర్‌కు అనుసరించి వస్తుంది. అనుసరించడం ఇబ్బందిగా ఉన్నప్పుడు ⌘⇧Lతో ఆఫ్ చేస్తారు.

తరచుగా వెళ్ళే స్థలాలు · వీక్షణ

తేడా చూడటం

⌘⇧Yతో ఆన్ చేస్తే లోకల్ మరియు రిమోట్‌లను పక్కపక్కనే పోల్చి వేరుగా ఉన్నవి·ఒక వైపు మాత్రమే ఉన్నవిని చూపిస్తుంది. అవసరమైనవి మాత్రమే పంపాలనుకున్నప్పుడు వాడతారు.

🌏 Mac మరియు Linux కొరియన్·జపనీస్·వియత్నామీస్ ఫైల్ పేర్లను వేర్వేరు బైట్‌లుగా రాస్తాయి. Berth జతచేసేటప్పుడు మాత్రమే పేర్లను సరిపోల్చి చూస్తుంది, కాబట్టి కంటికి ఒకేలా కనిపించే ఫైలు "ఒక వైపు మాత్రమే ఉంది"గా విడిపోదు. అసలు బదిలీలో సర్వర్‌లో ఉన్న పేరునే యథాతథంగా వాడుతుంది.

తొలగించడం

⌘⌫ సర్వర్ వైపు ట్రాష్‌కు తరలించడం డిఫాల్ట్, ఎప్పుడూ నిర్ధారణ అడుగుతుంది. ట్రాష్ ఆఫ్‌లో ఉన్న సర్వర్‌లో వెనక్కి తీసుకోలేమని ముందుగానే చెబుతుంది.

⌨️టెర్మినల్

vim·tmux·less యథాతథంగా నడిచే నిజమైన షెల్. మౌస్‌తో లాగి ఎంచుకుని ⌘Cతో కాపీ చేస్తే, కమాండ్ పంక్తి చివరి అదనపు ఖాళీ లేకుండా శుభ్రంగా పేస్ట్ అవుతుంది.

పేస్ట్ నిర్ధారణ

అనేక పంక్తులను పేస్ట్ చేస్తే ఏమి రన్ అవుతుందో ముందే చూపిస్తుంది. లైన్ బ్రేక్ ఉన్న పేస్ట్ వెంటనే కమాండ్‌గా మారిపోతుంది కాబట్టి. ప్రమాదకరంగా కనిపించేదాన్ని కారణంతో సహా చూపిస్తుంది.

పెద్దగా చూడటం

⌘↩తో ప్రస్తుత ప్రాంతాన్ని జూమ్ చేసి, మళ్లీ నొక్కి తిరిగి వస్తారు. ⌥⌘↩ ఒక్క ప్యానెల్‌ను మాత్రమే పెద్దది చేస్తుంది. అక్షర పరిమాణం ⌘+ · ⌘- · ⌘0. ⌘L తో టెర్మినల్‌ను క్లియర్ చేయండి — స్క్రీన్ మరియు స్క్రోల్‌బ్యాక్ తొలగిపోతాయి, ప్రస్తుత ప్రాంప్ట్ లైన్ మాత్రమే మిగులుతుంది.

🔌సీరియల్ కన్సోల్ (UART)

పరికరం ఎంచుకోవడం

⌃⌘Nతో సీరియల్ కన్సోల్‌ను జోడించి, సెట్టింగ్‌లలో కనెక్ట్ అయిన పరికరాన్ని ఎంచుకుంటారు. Berth పాత్‌ను కాదు, పరికరాన్ని గుర్తుంచుకుంటుంది — సీరియల్ నంబర్ ఉంటే దానితో, లేకపోతే రకంతో. వేరే USB స్థానంలో కనెక్ట్ చేసినా అదే పరికరాన్ని కనుగొంటుంది.

💡 ఆ సీరియల్ నంబర్ USB ద్వారా జాబితా చేయబడేదానికి చెందినది. USB-సీరియల్ అడాప్టర్ వాడితే అడాప్టర్‌నే గుర్తుంచుకున్నట్టు అవుతుంది కాబట్టి, అడాప్టర్‌ను మార్చితే మళ్లీ ఎంచుకోవాలి.

వేగం మరియు లైన్ సెట్టింగ్‌లు

వేగాన్ని జాబితా నుండి ఎంచుకోవచ్చు లేదా నేరుగా టైప్ చేయవచ్చు (1,500,000 లాంటి ప్రామాణికేతర విలువలు కూడా వాడొచ్చు — అడాప్టర్ ఆమోదించే విలువ అయ్యుండాలి). డిఫాల్ట్ 8N1 · ఫ్లో కంట్రోల్ లేదు, చాలా కన్సోల్‌లకు ఇదే విలువ.

⚠️ ఫ్లో కంట్రోల్ లేని UARTలో నిరంతర·భారీ కమ్యూనికేషన్‌లో పరికరం పంపడం ఆపేసే సమస్య ఉంటుంది. ఇది ఈ యాప్ ఒక్కదానికే పరిమితమైన సమస్య కాదు, లైన్ యొక్క లక్షణమే (అదే కేబుల్‌లో ఇతర ప్రోగ్రామ్‌లకూ ఇలాగే జరుగుతుంది), మూలం నుండి పరిష్కరించాలంటే 4-వైర్ కేబుల్‌లో ఫ్లో కంట్రోల్‌ను ఆన్ చేయడం లేదా బోర్డు వైపు వేగాన్ని తగ్గించడం.

రికార్డు బోర్డు

సీరియల్ సెషన్‌లో నేను టైప్ చేసిన కమాండ్ మరియు దాని సమాధానం సమయంతో పాటు కుడివైపు పేరుకుంటాయి. పాస్‌వర్డ్ అడిగిన చోట ఎంటర్ చేసినది దాచబడుతుంది.

షార్ట్‌కట్‌లు

యాప్ షార్ట్‌కట్‌లలో ఎప్పుడూ ఉంటుంది. · కలయికలు షెల్ మరియు TUI (vim·tmux) కి చెందినవి కాబట్టి యాప్ వాటిని తీసుకోదు.

⌨️ మౌస్ అవసరం లేదు. ఇక్కడి ప్రతి చర్యకూ షార్ట్‌కట్ ఉంది — చేతులు కీబోర్డ్‌పైనే ఉంచాలనుకునేవారి కోసం.
కీచేసేది
⌘N · ⌃⌘N · ⌘⇧Nసర్వర్ జోడించు · సీరియల్ కన్సోల్ జోడించు · ఫోల్డర్ సృష్టించు
⌘I · ⌘⇧Iఈ సర్వర్ సెట్టింగ్‌లు · ~/.ssh/config నుండి దిగుమతి చేయి
⌘Kఎక్కడికి వెళ్దాం — పేరుతో వెతికి నేరుగా వెళ్ళండి
⌘1⌘9సెషన్ మార్పిడి
⌃⌘← ప్యానెళ్ల మధ్య తరలింపు
⌘↩ · ⌥⌘↩జూమ్ / తిరిగి రా · ఈ ప్యానెల్‌ను మాత్రమే జూమ్ చేయి
⌘⇧S · ⌥⌘↑ ⌥⌘↓సైడ్‌బార్ · విభజన రేఖ తరలించడం
⌥⌘→ · ⌥⌘←అప్‌లోడ్ · డౌన్‌లోడ్
⌘D · ⌘R · ⌥⌘Nపిన్ చేయి/తీసివేయి · మళ్లీ చదువు · కొత్త ఫోల్డర్
⌘↓ · ⌘↑ · ⌥⌘Tలోతుగా వెళ్ళడం · వెనక్కి తీసుకోవడం · ట్రీ↔జాబితా
⌘⌫ · ⌘⇧Fరిమోట్ నుండి తొలగించు · సర్వర్‌లో వెతుకు
⌘⇧V · ⌘⇧L · ⌘⇧Yపాత్‌ను టెర్మినల్‌కు · టెర్మినల్‌ను అనుసరించడం · తేడా చూపు
⌘+ ⌘- ⌘0 · ⌘⇧Wఅక్షర పరిమాణం · ఈ సెషన్‌ను మూసివేయి
⌘L · ⌘] ⌘[టెర్మినల్ క్లియర్ · కుడి ప్యానెల్ ట్యాబ్‌లు మార్చు
⌘C · ⌘⇧P · ⌘⇧U · ⌘?కాపీ · రికార్డులో ఉంచు · మానిఫెస్ట్ మళ్లీ పంపు · యూజర్ గైడ్

తరచుగా అడిగే ప్రశ్నలు

పాస్‌వర్డ్ ఎక్కడ సేవ్ అవుతుంది?

macOS కీచైన్‌లో మాత్రమే సేవ్ అవుతుంది. సెట్టింగ్‌ల ఫైల్‌లో "సేవ్ చేయబడింది" అనే గుర్తు మాత్రమే మిగులుతుంది. కీచైన్‌ను కనెక్ట్ అయ్యే క్షణంలో ఒక్కసారే తెరుస్తుంది.

వినియోగ చరిత్రను సేకరిస్తారా?

లేదు. యాప్ లోపల ఎలాంటి ట్రాకింగ్ లేదు. ఏమి తెరుస్తారో, ఎక్కడ కనెక్ట్ అవుతారో లెక్కించదు.

సీరియల్ కన్సోల్ మధ్యలో ఆగిపోతుంది.

ఫ్లో కంట్రోల్ లేని UARTలో పెద్ద మొత్తంలో కమ్యూనికేషన్ చేస్తే ఏర్పడే లైన్ లక్షణం. 4-వైర్ కేబుల్ అయితే సెట్టింగ్‌లలో ఫ్లో కంట్రోల్ (RTS/CTS)‌ను ఆన్ చేయండి, 3-వైర్ అయితే బోర్డు వైపు వేగాన్ని తగ్గించడం లేదా అవుట్‌పుట్‌ను దశలవారీగా విభజించి చూడండి.

ఇప్పటికే వాడుతున్న SSH సెట్టింగ్‌లను మళ్లీ రాయాలా?

కాదు. ~/.ssh/config నుండి దిగుమతి చేస్తే అలియాస్‌తో యథాతథంగా కనెక్ట్ అవుతుంది, ఆ ఎంట్రీలోని హోస్ట్·పోర్ట్· వినియోగదారు·కీ·ProxyJumpను చదివి వాడుతుంది.

ProxyCommand వాడే సెట్టింగ్ ఉంది.

ProxyCommand బాహ్య ప్రోగ్రామ్‌ను ప్రారంభించే ఫీచర్ కాబట్టి App Store శాండ్‌బాక్స్‌లో వాడలేరు. జంప్ హోస్ట్ ద్వారా వెళ్ళే సెట్టింగ్ అయితే ProxyJump‌గా మార్చితే అలాగే పనిచేస్తుంది. ssh-agent కూడా అదే కారణంతో వాడలేరు, కీ ఫైల్‌ను నేరుగా చదివి పాస్‌వర్డ్ ఉన్న కీ అయితే కనెక్ట్ అయ్యేటప్పుడు పాస్‌వర్డ్‌ను అడుగుతుంది.

మద్దతు ఉన్న macOS వెర్షన్ ఏది?

macOS 14(Sonoma) లేదా అంతకంటే కొత్తది, Apple Silicon మరియు Intel రెండూ మద్దతు ఇస్తాయి.

సహాయపడిందని అనిపిస్తే

Berth ఉచితం. మద్దతు ఇవ్వండితో అభివృద్ధికి సహాయం చేయవచ్చు.