Files
test-repo/docs/.vitepress/theme/components/appendix/ports-localhost/LocalhostLoopbackDemo.vue
T
sanbuphy 6098908eee feat(docs): add interactive demos and complete content for development tools
- Add Vue components for interactive demos (SSH auth, regex, env vars, ports)
- Complete markdown content for SSH, regex, environment variables, and ports
- Remove placeholder "待实现" sections and replace with detailed guides
- Add visual explanations for key concepts like ports and localhost
- Include practical examples and troubleshooting tips
- Add component for showing evolution from transistors to CPU
- Improve documentation structure and navigation
- Add security best practices for API keys and environment variables
2026-02-21 10:04:47 +08:00

453 lines
10 KiB
Vue
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<script setup>
import { ref, reactive } from 'vue'
const requestUrl = ref('http://localhost:3000/api/hello')
const isRequesting = ref(false)
const requestStep = ref(0)
const responseText = ref('')
const steps = [
{ label: '浏览器', desc: '你在地址栏输入 URL', icon: '🌐' },
{ label: 'DNS 解析', desc: 'localhost → 127.0.0.1(不出网)', icon: '📖' },
{ label: '网络层', desc: '数据包发往 127.0.0.1(环回接口)', icon: '🔄' },
{ label: '本机服务', desc: '端口 3000 上的程序接收请求', icon: '⚙️' },
{ label: '返回响应', desc: '{ "message": "Hello!" }', icon: '📨' }
]
const aliases = reactive([
{ name: 'localhost', ip: '127.0.0.1', desc: '标准域名别名', active: false },
{ name: '127.0.0.1', ip: '127.0.0.1', desc: 'IPv4 环回地址', active: false },
{ name: '::1', ip: '::1', desc: 'IPv6 环回地址', active: false },
{ name: '0.0.0.0', ip: '0.0.0.0', desc: '监听所有网卡', active: false }
])
const selectedAlias = ref(0)
async function simulateRequest() {
if (isRequesting.value) return
isRequesting.value = true
requestStep.value = 0
responseText.value = ''
for (let i = 0; i < steps.length; i++) {
requestStep.value = i + 1
await new Promise(r => setTimeout(r, 700))
}
responseText.value = '{ "message": "Hello from localhost!" }'
await new Promise(r => setTimeout(r, 500))
isRequesting.value = false
}
function selectAlias(index) {
selectedAlias.value = index
aliases.forEach((a, i) => { a.active = i === index })
}
</script>
<template>
<div class="localhost-demo">
<div class="control-panel">
<div class="url-bar">
<span class="url-icon">🔗</span>
<input
v-model="requestUrl"
type="text"
class="url-input"
readonly
>
<button
class="action-btn"
:disabled="isRequesting"
@click="simulateRequest"
>
{{ isRequesting ? '请求中...' : '发送请求' }}
</button>
</div>
</div>
<div class="visualization-area">
<div class="flow-container">
<div
v-for="(step, i) in steps"
:key="i"
:class="['flow-step', {
active: requestStep > i,
current: requestStep === i + 1
}]"
>
<div class="step-icon">{{ step.icon }}</div>
<div class="step-info">
<span class="step-label">{{ step.label }}</span>
<span class="step-desc">{{ step.desc }}</span>
</div>
<div v-if="i < steps.length - 1" :class="['step-arrow', { active: requestStep > i }]"></div>
</div>
</div>
<transition name="fade">
<div v-if="responseText" class="response-box">
<span class="response-label">响应结果</span>
<code>{{ responseText }}</code>
</div>
</transition>
<div class="loopback-explain">
<div class="loopback-diagram">
<div class="loopback-node app">
<span>你的应用</span>
<span class="small">浏览器</span>
</div>
<div class="loopback-arrow">
<span class="arrow-text">请求不离开本机</span>
<svg width="80" height="60" viewBox="0 0 80 60">
<path d="M10 10 Q40 55 70 10" stroke="var(--vp-c-brand)" stroke-width="2" fill="none" marker-end="url(#arrowhead)" />
<defs>
<marker id="arrowhead" markerWidth="6" markerHeight="4" refX="5" refY="2" orient="auto">
<polygon points="0 0, 6 2, 0 4" fill="var(--vp-c-brand)" />
</marker>
</defs>
</svg>
</div>
<div class="loopback-node server">
<span>本地服务</span>
<span class="small">:3000</span>
</div>
</div>
</div>
</div>
<div class="alias-section">
<div class="alias-title">localhost "马甲"点击查看说明</div>
<div class="alias-grid">
<div
v-for="(alias, i) in aliases"
:key="i"
:class="['alias-card', { active: selectedAlias === i }]"
@click="selectAlias(i)"
>
<code class="alias-name">{{ alias.name }}</code>
<span class="alias-ip"> {{ alias.ip }}</span>
</div>
</div>
<div class="alias-desc">
{{ aliases[selectedAlias].desc }}
<template v-if="selectedAlias === 0">
这是写在你电脑 <code>/etc/hosts</code> 文件里的映射浏览器看到 <code>localhost</code> 直接解析为 <code>127.0.0.1</code>不会去问 DNS 服务器
</template>
<template v-else-if="selectedAlias === 1">
<code>127.0.0.1</code> IPv4 "环回地址"发到这个地址的数据包永远不会离开本机操作系统直接在内部把它"折返"回来
</template>
<template v-else-if="selectedAlias === 2">
<code>::1</code> IPv6 版本的环回地址功能和 <code>127.0.0.1</code> 完全一样只不过是 IPv6 格式
</template>
<template v-else>
<code>0.0.0.0</code> 不是"某一个地址"而是"所有地址"当服务监听 <code>0.0.0.0:3000</code> 意味着无论从哪个网卡包括局域网 IP 127.0.0.1都能访问
</template>
</div>
</div>
<div class="info-box">
<strong>核心概念</strong>localhost 就是"自己找自己"数据包通过环回接口loopback interface在本机内部折返不经过网线不经过路由器速度极快且完全安全
</div>
</div>
</template>
<style scoped>
.localhost-demo {
border: 1px solid var(--vp-c-divider);
border-radius: 6px;
background-color: var(--vp-c-bg-soft);
overflow: hidden;
margin: 0.5rem 0;
}
.control-panel {
padding: 1rem;
background: var(--vp-c-bg);
border-bottom: 1px solid var(--vp-c-divider);
}
.url-bar {
display: flex;
align-items: center;
gap: 0.5rem;
background: var(--vp-c-bg-alt);
border: 1px solid var(--vp-c-divider);
border-radius: 6px;
padding: 0.4rem 0.6rem;
}
.url-icon { font-size: 1rem; }
.url-input {
flex: 1;
border: none;
background: transparent;
font-family: var(--vp-font-family-mono);
font-size: 0.85rem;
color: var(--vp-c-text-1);
outline: none;
}
.action-btn {
padding: 0.35rem 0.75rem;
background: var(--vp-c-brand);
color: white;
border: none;
border-radius: 4px;
cursor: pointer;
font-size: 0.85rem;
font-weight: 600;
white-space: nowrap;
transition: opacity 0.2s;
}
.action-btn:disabled {
opacity: 0.6;
cursor: not-allowed;
}
.visualization-area {
padding: 1rem;
}
.flow-container {
display: flex;
align-items: stretch;
gap: 0;
overflow-x: auto;
padding-bottom: 0.5rem;
}
.flow-step {
display: flex;
align-items: center;
gap: 0.4rem;
padding: 0.5rem 0.6rem;
background: var(--vp-c-bg);
border: 1px solid var(--vp-c-divider);
border-radius: 6px;
opacity: 0.4;
transition: all 0.3s;
flex-shrink: 0;
}
.flow-step.active {
opacity: 1;
}
.flow-step.current {
opacity: 1;
border-color: var(--vp-c-brand);
box-shadow: 0 0 8px rgba(100, 108, 255, 0.3);
}
.step-icon { font-size: 1.2rem; }
.step-info {
display: flex;
flex-direction: column;
}
.step-label {
font-weight: 600;
font-size: 0.82rem;
}
.step-desc {
font-size: 0.72rem;
color: var(--vp-c-text-3);
}
.step-arrow {
font-size: 1.2rem;
color: var(--vp-c-divider);
transition: color 0.3s;
margin: 0 0.1rem;
flex-shrink: 0;
}
.step-arrow.active {
color: var(--vp-c-brand);
}
.response-box {
margin-top: 0.75rem;
padding: 0.6rem 0.75rem;
background: rgba(16, 185, 129, 0.1);
border: 1px solid var(--vp-c-green-1);
border-radius: 6px;
font-size: 0.85rem;
}
.response-label {
font-weight: 600;
margin-right: 0.5rem;
}
.response-box code {
font-family: var(--vp-font-family-mono);
font-size: 0.82rem;
}
.loopback-explain {
margin-top: 1rem;
padding: 1rem;
background: var(--vp-c-bg);
border-radius: 6px;
border: 1px solid var(--vp-c-divider);
}
.loopback-diagram {
display: flex;
align-items: center;
justify-content: center;
gap: 0.5rem;
}
.loopback-node {
padding: 0.75rem 1rem;
border-radius: 8px;
text-align: center;
font-weight: 600;
font-size: 0.88rem;
display: flex;
flex-direction: column;
gap: 0.15rem;
}
.loopback-node .small {
font-size: 0.72rem;
font-weight: 400;
color: var(--vp-c-text-3);
}
.loopback-node.app {
background: rgba(59, 130, 246, 0.15);
border: 1px solid #3b82f6;
color: #3b82f6;
}
.loopback-node.server {
background: rgba(16, 185, 129, 0.15);
border: 1px solid #10b981;
color: #10b981;
}
.loopback-arrow {
display: flex;
flex-direction: column;
align-items: center;
}
.arrow-text {
font-size: 0.72rem;
color: var(--vp-c-brand);
font-weight: 500;
}
.alias-section {
padding: 1rem;
border-top: 1px solid var(--vp-c-divider);
}
.alias-title {
font-weight: 600;
font-size: 0.9rem;
margin-bottom: 0.5rem;
}
.alias-grid {
display: grid;
grid-template-columns: repeat(4, 1fr);
gap: 0.5rem;
margin-bottom: 0.75rem;
}
.alias-card {
padding: 0.5rem;
background: var(--vp-c-bg);
border: 1px solid var(--vp-c-divider);
border-radius: 6px;
text-align: center;
cursor: pointer;
transition: all 0.2s;
}
.alias-card:hover {
border-color: var(--vp-c-brand);
}
.alias-card.active {
border-color: var(--vp-c-brand);
background: rgba(100, 108, 255, 0.08);
}
.alias-name {
display: block;
font-size: 0.82rem;
font-weight: 600;
}
.alias-ip {
font-size: 0.72rem;
color: var(--vp-c-text-3);
}
.alias-desc {
font-size: 0.85rem;
color: var(--vp-c-text-2);
padding: 0.6rem;
background: var(--vp-c-bg);
border-radius: 6px;
border: 1px solid var(--vp-c-divider);
line-height: 1.6;
}
.alias-desc code {
font-size: 0.8rem;
background: var(--vp-c-bg-alt);
padding: 0.1rem 0.3rem;
border-radius: 3px;
}
.info-box {
padding: 0.75rem 1rem;
background: var(--vp-c-bg);
border-top: 1px solid var(--vp-c-divider);
font-size: 0.88rem;
color: var(--vp-c-text-2);
display: flex;
gap: 0.25rem;
}
.info-box strong {
white-space: nowrap;
flex-shrink: 0;
}
.fade-enter-active, .fade-leave-active {
transition: opacity 0.3s;
}
.fade-enter-from, .fade-leave-to {
opacity: 0;
}
@media (max-width: 640px) {
.alias-grid {
grid-template-columns: repeat(2, 1fr);
}
.flow-container {
flex-wrap: wrap;
gap: 0.25rem;
}
.step-arrow {
display: none;
}
.loopback-diagram {
flex-direction: column;
}
}
</style>